ホーム › Graphics.Direct2D › ID2D1GdiInteropRenderTarget

ID2D1GdiInteropRenderTarget

COM

IIDe0db51c3-6f77-4bae-b3d5-e47509b35838継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

GDI 描画コマンドを受け付けられるデバイスコンテキストへのアクセスを提供します。

解説(Remarks)

ID2D1GdiInteropRenderTarget オブジェクトを直接作成することはありません。代わりに、既存のレンダーターゲットインスタンスの QueryInterface メソッドを使用して、そのレンダーターゲットの ID2D1GdiInteropRenderTarget バージョンを取得します。

すべてのレンダーターゲットが ID2D1GdiInteropRenderTarget インターフェイスをサポートするわけではありません。レンダーターゲットは GDI 互換である必要があり(レンダーターゲットの作成時に D2D1_RENDER_TARGET_USAGE_GDI_COMPATIBLE フラグが指定されていること)、DXGI_FORMAT_B8G8R8A8_UNORM ピクセル形式を使用し、さらに D2D1_ALPHA_MODE_PREMULTIPLIED または D2D1_ALPHA_MODE_IGNORE アルファモードを使用している必要があります。

QueryInterface メソッドは常に成功する点に注意してください。レンダーターゲットが ID2D1GdiInteropRenderTarget インターフェイスをサポートしていない場合、GetDC の呼び出しが失敗します。(CreateCompatibleRenderTarget メソッドで作成されたレンダーターゲットの場合、それを作成したレンダーターゲットがこれらの設定を持っている必要があります。)

特定のレンダーターゲットが ID2D1GdiInteropRenderTarget インターフェイスをサポートしているかどうかをテストするには、GDI 互換と適切なピクセル形式を指定した D2D1_RENDER_TARGET_PROPERTIES を作成し、レンダーターゲットの IsSupported メソッドを呼び出して、レンダーターゲットが GDI 互換であるかどうかを確認します。

メソッド 2

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT GetDC(D2D1_DC_INITIALIZE_MODE mode, HDC* hdc)

このレンダーターゲットに関連付けられたデバイスコンテキストを取得します。

mode	D2D1_DC_INITIALIZE_MODE	in	デバイスコンテキストをクリアすべきかどうかを指定する値です。
hdc	HDC*	out	このメソッドが返るとき、このレンダーターゲットに関連付けられたデバイスコンテキストが格納されます。このパラメーターの領域を確保しておく必要があります。

戻り値

型: HRESULT

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

解説(Remarks)

このメソッドを呼び出すと、レンダーターゲットがフラッシュされます。

このコマンドは、BeginDraw の後、EndDraw の前にのみ呼び出すことができます。

注意 Windows 7 以前では、PushAxisAlignedClip/PopAxisAlignedClip コマンドの間、または PushLayer/PopLayer の間で GetDC を呼び出すべきではありません。ただし、この制限は Windows 8 以降には当てはまりません。

ReleaseDC は、GetDC の各呼び出しに対して 1 回ずつ呼び出す必要があります。

vtbl 4 HRESULT ReleaseDC(RECT* update)

GetDC メソッドで取得したデバイスコンテキストを使用した描画が完了したことを示します。

update

RECT*

inoptional

デバイスコンテキストの変更された領域を指定します。レンダーターゲット全体を指定する場合は NULL を指定します。

戻り値

型: HRESULT

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

解説(Remarks)

ReleaseDC は、GetDC の各呼び出しに対して 1 回ずつ呼び出す必要があります。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数:

#define global IID_ID2D1GdiInteropRenderTarget "{E0DB51C3-6F77-4BAE-B3D5-E47509B35838}"
#usecom global ID2D1GdiInteropRenderTarget IID_ID2D1GdiInteropRenderTarget "{}"
#comfunc global ID2D1GdiInteropRenderTarget_GetDC      3 int,sptr
#comfunc global ID2D1GdiInteropRenderTarget_ReleaseDC  4 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_ID2D1GdiInteropRenderTarget "{E0DB51C3-6F77-4BAE-B3D5-E47509B35838}"
#usecom global ID2D1GdiInteropRenderTarget IID_ID2D1GdiInteropRenderTarget "{}"
#comfunc global ID2D1GdiInteropRenderTarget_GetDC      3 int,sptr
#comfunc global ID2D1GdiInteropRenderTarget_ReleaseDC  4 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。