IDXGIResource1::CreateSubresourceSurface メソッド (dxgi1_2.h)

サブリソースサーフェスオブジェクトを作成します。

構文

HRESULT CreateSubresourceSurface(
        UINT          index,
  [out] IDXGISurface2 **ppSurface
);

パラメーター

index

列挙するサブリソースサーフェスオブジェクトのインデックス。

[out] ppSurface

index パラメーターで指定された位置に作成されたサブリソース サーフェス オブジェクトを表す IDXGISurface2 インターフェイスへのポインターのアドレス。

戻り値

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

• インデックスが範囲外の場合、またはサブリソースが有効なサーフェスでない場合にDXGI_ERROR_INVALID_CALLします。
• サブリソース サーフェス オブジェクトを作成するために十分なメモリが使用できない場合にE_OUTOFMEMORYします。

注釈

サブリソース サーフェス オブジェクトは 、IDXGISurface1 と間接的に IDXGISurface を継承する IDXGISurface2 インターフェイス を実装します。 したがって、元のリソース インターフェイス オブジェクトが GDI 相互運用可能フラグ (D3D11_RESOURCE_MISC_GDI_COMPATIBLE) で作成された場合、IDXGISurface1 の GDI 相互運用可能なメソッドが機能します。

CreateSubresourceSurface は、 CreateSubresourceSurface が呼び出されるリソース インターフェイスに基づいてサブリソース サーフェスを作成します。 たとえば、元のリソース インターフェイス オブジェクトが 2D テクスチャの場合、作成されたサブリソース サーフェスも 2D テクスチャになります。

CreateSubresourceSurface を使用してステレオ リソースの一部を作成すると、ステレオ リソースの左側または右側で Direct2D を使用できます。

要件

こちらもご覧ください

IDXGIResource1