IDirect3DDevice9::CreateOffscreenPlainSurface
オフスクリーン サーフェスを作成します。
HRESULT
CreateOffscreenPlainSurface(
UINT Width,
UINT Height,
D3DFORMAT Format,
D3DPOOL Pool,
IDirect3DSurface9** ppSurface,
HANDLE* pSharedHandle
);
パラメータ
- Width
サーフェスの幅です。 - Height
サーフェスの高さです。 - Format
サーフェスのフォーマットです。「D3DFORMAT」を参照してください。 - Pool
サーフェス プール タイプです。「D3DPOOL」を参照してください。 - ppSurface
作成された IDirect3DSurface9 インターフェイスへのポインターです。 - pSharedHandle
予約済みです。このパラメーターを NULL に設定します。このパラメーターを Windows Vista の Direct3D 9 で使用して、リソースを共有することができます。
戻り値
メソッドが成功した場合は、D3D_OK を返します。メソッドが失敗した場合は、次の値を返します。D3DERR_INVALIDCALL
解説
D3DPOOL_SCRATCH は、DirectX 8.x のメソッドである CreateImageSurface で作成されたサーフェスと同じ特性を持つサーフェスを返します。
D3DPOOL_DEFAULT は、IDirect3DDevice9::StretchRect および IDirect3DDevice9::ColorFill での使用に適したプールです。
オフスクリーン プレーン サーフェスの作成時は、D3DPOOL_MANAGED は使用できません。メモリー プールの詳細については、「D3DPOOL」を参照してください。
オフスクリーン プレーン サーフェスは、そのプール タイプに関係なく常にロック可能です。
要件
ヘッダー: D3D9.h 宣言
ライブラリ: D3D9.lib 内容