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

関連項目

DXGI インターフェイス

ID3D10Device::CreateTexture2D

ID3D11Device::CreateTexture2D

IDXGIDevice