IDirect3DDevice9Ex::CreateOffscreenPlainSurfaceEx メソッド (d3d9.h)

画面外画面を作成します。

構文

HRESULT CreateOffscreenPlainSurfaceEx(
  [in]          UINT              Width,
  [in]          UINT              Height,
  [in]          D3DFORMAT         Format,
  [in]          D3DPOOL           Pool,
  [out, retval] IDirect3DSurface9 **ppSurface,
  [in]          HANDLE            *pSharedHandle,
  [in]          DWORD             Usage
);

パラメーター

[in] Width

型: UINT

サーフェスの幅。

[in] Height

型: UINT

サーフェスの高さ。

[in] Format

型: D3DFORMAT

サーフェスの形式。 「D3DFORMAT」を参照してください。

[in] Pool

種類: D3DPOOL

サーフェス プールの種類。 「D3DPOOL」を参照してください。

[out, retval] ppSurface

種類: IDirect3DSurface9**

作成された IDirect3DSurface9 インターフェイスへのポインター。

[in] pSharedHandle

型: HANDLE*

予約済み。 このパラメーターを NULL に設定 します。 このパラメーターは、Direct3D 9 for Windows Vista で リソースを共有するために使用できます。

[in] Usage

種類: DWORD

1 つ以上の D3DUSAGE 定数を組み合わせて使用します。この定数は、一緒に ORD にすることができます。 値 0 は、使用量がないことを示します。

戻り値

種類: HRESULT

メソッドが成功した場合、戻り値はD3D_OK。 メソッドが失敗した場合、戻り値は次のようになります: D3DERR_INVALIDCALL。

解説

D3DPOOL_SCRATCHは、DirectX 8.x メソッド CreateImageSurface によって作成されたサーフェスと同じ特性を持つサーフェスを返します。

D3DPOOL_DEFAULTは、 IDirect3DDevice9::StretchRect および IDirect3DDevice9::ColorFill で使用するための適切なプールです。

オフスクリーンプレーンサーフェスを作成する場合、D3DPOOL_MANAGEDは許可されません。 メモリ プールの詳細については、「 D3DPOOL」を参照してください。

オフスクリーンプレーンサーフェスは、プールの種類に関係なく、常にロック可能です。

要件

関連項目

IDirect3DDevice9Ex