IDXGIDevice::CreateSurface メソッド (dxgi.h)
サーフェスを返します。 このメソッドは内部的に使用されるため、アプリケーションで直接呼び出さないでください。
構文
HRESULT CreateSurface(
[in] const DXGI_SURFACE_DESC *pDesc,
UINT NumSurfaces,
DXGI_USAGE Usage,
[in, optional] const DXGI_SHARED_RESOURCE *pSharedResource,
[out] IDXGISurface **ppSurface
);
パラメーター
[in] pDesc
型: const DXGI_SURFACE_DESC*
サーフェスを記述 するDXGI_SURFACE_DESC 構造体へのポインター。
NumSurfaces
型: UINT
作成するサーフェスの数。
Usage
種類: DXGI_USAGE
サーフェスの使用方法を指定する DXGI_USAGE フラグ。
[in, optional] pSharedResource
型: const DXGI_SHARED_RESOURCE*
このようなリソースのビューを開くために共有リソース情報を含む DXGI_SHARED_RESOURCE 構造体への省略可能なポインター。
[out] ppSurface
種類: IDXGISurface**
最初に作成されたサーフェスへの IDXGISurface インターフェイス ポインターのアドレス。
戻り値
種類: HRESULT
成功した場合はS_OKを返します。それ以外の場合はエラー コード。 エラー コードの一覧については、「 DXGI_ERROR」を参照してください。
解説
CreateSurface メソッドは、1 つ以上のデバイス間でデータを交換するバッファーを作成します。 これは内部的に使用されるため、直接呼び出すべきではありません。
ランタイムは、サーフェスを表す Direct3D リソース オブジェクトを作成するときに 、IDXGISurface インターフェイスを自動的に作成します。 たとえば、ランタイムは ID3D11Device::CreateTexture2D または ID3D10Device::CreateTexture2D を呼び出して 2D テクスチャを作成するときに IDXGISurface インターフェイスを作成します。 2D テクスチャ サーフェスを表す IDXGISurface インターフェイスを取得するには、 ID3D11Texture2D::QueryInterface または ID3D10Texture2D::QueryInterface を呼び出します。 この呼び出しでは、 IDXGISurface の識別子を渡す必要があります。 2D テクスチャに MIP マップ レベルが 1 つだけあり、テクスチャの配列で構成されていない場合、 QueryInterface は成功し、 IDXGISurface インターフェイス ポインターへのポインターを返します。 それ以外の場合、 QueryInterface は失敗し、 IDXGISurface へのポインターは返されません。
要件
| 対象プラットフォーム | Windows |
| ヘッダー | dxgi.h |
| Library | DXGI.lib |