IDXGISurface2

IDXGISurface2 インターフェイスは、IDXGISurface1 インターフェイスを拡張し、サブリソースサーフェスのサポートと、共有リソースへのハンドルの取得を追加します。

イメージデータオブジェクトは、メモリ上の 2D 領域であり、一般にサーフェスと呼ばれます。出力(アウトプット)からサーフェスを取得するには、IDXGIOutput::GetDisplaySurfaceData を呼び出します。次に、IDXGIOutput::GetDisplaySurfaceData が返す IDXGISurface オブジェクトに対して QueryInterface を呼び出して、IDXGISurface2 インターフェイスを取得します。

IDXGISurface をサポートするオブジェクトはすべて、IDXGISurface2 もサポートします。

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

IDXGIResource1::CreateSubresourceSurface メソッドを呼び出すことで、ステレオリソースの 1 つのサブリソースを参照する IDXGISurface2 インターフェイスを作成できます。

サブリソースサーフェスを支える親リソースとサブリソースインデックスを取得します。

成功した場合は S_OK を返します。それ以外の場合は、次のいずれかの値を返します。

• オブジェクトが riid パラメーターで指定された GUID を実装していない場合は E_NOINTERFACE。
• その他、DXGI_ERROR トピックで説明されているエラーコードが返される場合があります。

IDXGIResource1::CreateSubresourceSurface メソッドが作成するサブリソースサーフェスオブジェクトの場合、GetResource は、サブリソースサーフェスの作成に使用された値をそのまま返します。

IDXGISurface を実装する現在のオブジェクトは、リソースまたはビューのいずれかです。これらのオブジェクトに対する GetResource は、それぞれ「this」またはビューを支えるリソースを返します。この場合、サブリソースインデックスは 0 です。