D3DXCheckCubeTextureRequirements
キューブ テクスチャー作成パラメーターをチェックします。
HRESULT
D3DXCheckCubeTextureRequirements(
LPDIRECT3DDEVICE9 pDevice,
UINT * pSize,
UINT * pNumMipLevels,
DWORD Usage,
D3DFORMAT * pFormat,
D3DPOOL Pool
);
パラメータ
- pDevice
IDirect3DDevice9 インターフェイスへのポインターです。キューブ テクスチャーに関連付けられるデバイスを示します。 - pSize
幅と高さの要求値 (ピクセル単位) へのポインターか、NULL を指定します。また、このパラメーターには訂正後のサイズが返されます。 - pNumMipLevels
要求するミップマップ レベル数のポインターか、NULL を指定します。また、このパラメーターは、ミップマップ レベルの訂正後の数値が返されます。 - Usage
0 または D3DUSAGE_RENDERTARGET を指定します。このフラグを D3DUSAGE_RENDERTARGET に指定すると、サーフェスをレンダー ターゲットとして使用します。その後でリソースを IDirect3DDevice9::SetRenderTarget メソッドの pNewRenderTarget パラメーターとして渡すことができます。D3DUSAGE_RENDERTARGET を指定する場合は、アプリケーションで IDirect3D9::CheckDeviceFormat を呼び出して、デバイスがこの処理をサポートしていることを確認する必要があります。 - pFormat
D3DFORMAT 列挙型のメンバーへのポインターです。必要なピクセル フォーマットか、NULL を指定します。また、このパラメーターには訂正後のフォーマットが返されます。 - Pool
D3DPOOL 列挙型のメンバーです。テクスチャーを配置するメモリー クラスを示します。
戻り値
成功すると、D3D_OK を返します。失敗した場合は、次の戻り値のいずれかを返します。D3DERR_NOTAVAILABLE、D3DERR_INVALIDCALL
解説
この関数のパラメーターが無効な場合、訂正後のパラメーターが返ります。
キューブ テクスチャーは他のサーフェスと異なり、サーフェスのコレクションになります。キューブ テクスチャーで IDirect3DDevice9::SetRenderTarget を呼び出すには、IDirect3DCubeTexture9::GetCubeMapSurface を使用して個別の面を選択し、その結果のサーフェスを IDirect3DDevice9::SetRenderTarget に渡す必要があります。
要件
ヘッダー: D3dx9tex.h 宣言
ライブラリ: D3dx9.lib 内容