IDXGISurface インターフェイス (dxgi.h)

  • [アーティクル]

IDXGISurface インターフェイスは、イメージ データ オブジェクトのメソッドを実装します。

継承

IDXGISurface インターフェイスは、IDXGIDeviceSubObject から派生します。

メソッド

IDXGISurface インターフェイスには、これらのメソッドがあります。

 
IDXGISurface::GetDesc

サーフェスの説明を取得します。
IDXGISurface::Map

サーフェスに含まれるデータへのポインターを取得し、サーフェスへの GPU アクセスを拒否します。
IDXGISurface::Unmap

IDXGISurface::Map によって取得されたサーフェスへのポインターを無効にし、リソースへの GPU アクセスを再度有効にします。

解説

イメージ データ オブジェクトは、メモリの 2D セクションであり、一般にサーフェスと呼ばれます。 出力からサーフェスを取得するには、 IDXGIOutput::GetDisplaySurfaceData を呼び出します。

Direct3D 12より前のランタイムは、サーフェスを表す Direct3D リソース オブジェクトを作成するときに、IDXGISurface インターフェイスを自動的に作成します。 IDXGISurface インターフェイスは、Direct3D 12ではサポートされていません。 たとえば、ID3D11Device::CreateTexture2D または ID3D10Device::CreateTexture2D を呼び出して 2D テクスチャを作成すると、ランタイムによって IDXGISurface インターフェイスが作成されます。 2D テクスチャ サーフェスを表す IDXGISurface インターフェイスを取得するには、 ID3D11Texture2D::QueryInterface または ID3D10Texture2D::QueryInterface を呼び出します。 この呼び出しでは、 IDXGISurface の識別子を渡す必要があります。 2D テクスチャの MIP マップ レベルが 1 つだけで、テクスチャの配列で構成されていない場合、 QueryInterface は成功し、 IDXGISurface インターフェイス ポインターへのポインターを返します。 それ以外の場合、 QueryInterface は失敗し、 IDXGISurface へのポインターは返されません。

要件

   
対象プラットフォーム Windows
ヘッダー dxgi.h

関連項目

DXGI インターフェイス

IDXGIDeviceSubObject