IDXGISurface1 インターフェイス (dxgi.h)
IDXGISurface1 インターフェイスは、Windows グラフィックス デバイス インターフェイス (GDI) を使用して Microsoft DirectX グラフィックス インフラストラクチャ (DXGI) サーフェスにレンダリングするためのサポートを追加することで、IDXGISurface を拡張します。
継承
IDXGISurface1 インターフェイスは IDXGISurface から継承されます。 IDXGISurface1 には、次の種類のメンバーもあります。
メソッド
IDXGISurface1 インターフェイスには、これらのメソッドがあります。
| IDXGISurface1::GetDC Windows グラフィックス デバイス インターフェイス (GDI) を使用して Microsoft DirectX グラフィックス インフラストラクチャ (DXGI) サーフェスにレンダリングできるデバイス コンテキスト (DC) を返します。 |
| IDXGISurface1::ReleaseDC 現在のサーフェスに関連付けられている GDI デバイス コンテキスト (DC) を解放し、Direct3D を使用してレンダリングできるようにします。 |
注釈
このインターフェイスは、Windows Vista および Windows Server 2008 に付属する DXGI 1.0 ではサポートされていません。 DXGI 1.1 のサポートが必要です。これは、Windows 7、Windows Server 2008 R2、および Service Pack 2 (SP2) (KB 971644) と Windows Server 2008 (KB 971512) を使用した Windows Vista の更新プログラムとして利用できます。
イメージ データ オブジェクトは、メモリの 2D セクションであり、一般にサーフェスと呼ばれます。 出力からサーフェスを取得するには、 IDXGIOutput::GetDisplaySurfaceData を呼び出します。 次に、IDXGIOutput::GetDisplaySurfaceData が返す IDXGISurface オブジェクトで QueryInterface を呼び出して、IDXGISurface1 インターフェイスを取得します。
IDXGISurface をサポートするすべてのオブジェクトは、IDXGISurface1 もサポートします。
ランタイムは、サーフェスを表す Direct3D リソース オブジェクトを作成するときに 、IDXGISurface1 インターフェイスを自動的に作成します。 たとえば、ID3D11Device::CreateTexture2D または ID3D10Device::CreateTexture2D を呼び出して 2D テクスチャを作成すると、ランタイムによって IDXGISurface1 インターフェイスが作成されます。 2D テクスチャ サーフェスを表す IDXGISurface1 インターフェイスを取得するには、 ID3D11Texture2D::QueryInterface または ID3D10Texture2D::QueryInterface を呼び出します。 この呼び出しでは、 IDXGISurface1 の識別子を渡す必要があります。 2D テクスチャの MIP マップ レベルが 1 つだけで、テクスチャの配列で構成されていない場合、 QueryInterface は成功し、 IDXGISurface1 インターフェイス ポインターへのポインターを返します。 それ以外の場合、 QueryInterface は失敗し、 IDXGISurface1 へのポインターは返されません。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | dxgi.h |