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