D3DXCheckCubeTextureRequirements 関数

  • [アーティクル]

キューブ テクスチャ作成パラメーターを確認します。

構文

HRESULT D3DXCheckCubeTextureRequirements(
  _In_    LPDIRECT3DDEVICE9 pDevice,
  _Inout_ UINT              *pSize,
  _Inout_ UINT              *pNumMipLevels,
  _In_    DWORD             Usage,
  _Inout_ D3DFORMAT         *pFormat,
  _In_    D3DPOOL           Pool
);

パラメーター

pDevice [in]

種類: LPDIRECT3DDEVICE9

キューブ テクスチャに関連付けられるデバイスを表す IDirect3DDevice9 インターフェイスへのポインター。

pSize [in, out]

型: UINT*

要求された幅と高さをピクセル単位で指すポインター、または NULL。 修正されたサイズを返します。

pNumMipLevels [in, out]

型: UINT*

要求されたミップマップ レベルの数 ( NULL) へのポインター。 ミップマップ レベルの修正された数を返します。

使用法 [入力]

型: DWORD

0 または D3DUSAGE_RENDERTARGET。 このフラグを D3DUSAGE_RENDERTARGET に設定すると、サーフェスがレンダー ターゲットとして使用されることを示します。 その後、 SetRenderTarget メソッドの pNewRenderTarget パラメーターにリソースを渡すことができます。 D3DUSAGE_RENDERTARGETが指定されている場合、アプリケーションは CheckDeviceFormat を呼び出して、デバイスがこの操作をサポートしていることをチェックする必要があります。

pFormat [in, out]

型: D3DFORMAT*

D3DFORMAT 列挙型のメンバーへのポインター。 目的のピクセル形式 ( NULL) を指定します。 修正された形式を返します。

プール [入力]

種類: D3DPOOL

テクスチャを配置するメモリ クラスを記述する D3DPOOL 列挙型のメンバー。

戻り値

型: HRESULT

関数が成功した場合、戻り値はD3D_OK。 関数が失敗した場合、戻り値は次のいずれかになります:D3DERR_NOTAVAILABLE、D3DERR_INVALIDCALL。

解説

この関数のパラメーターが無効な場合、この関数は修正されたパラメーターを返します。

キューブ テクスチャは、サーフェスのコレクションであるという点で、他のサーフェスとは異なります。 キューブ テクスチャで SetRenderTarget を 呼び出すには、 GetCubeMapSurface を使用して個々の顔を選択し、結果のサーフェスを SetRenderTarget に渡す必要があります。

要件

要件 値
ヘッダー
D3dx9tex.h
ライブラリ
D3dx9.lib

関連項目

D3DX 9 のテクスチャ関数