D3DXCheckTextureRequirements 関数

テクスチャ作成パラメーターをチェックします。

構文

HRESULT D3DXCheckTextureRequirements(
  _In_    LPDIRECT3DDEVICE9 pDevice,
  _Inout_ UINT              *pWidth,
  _Inout_ UINT              *pHeight,
  _Inout_ UINT              *pNumMipLevels,
  _In_    DWORD             Usage,
  _Inout_ D3DFORMAT         *pFormat,
  _In_    D3DPOOL           Pool
);

パラメーター

pDevice [in]

種類: LPDIRECT3DDEVICE9

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

pWidth [in, out]

型: UINT*

要求された幅へのポインター (ピクセル単位)、または NULL。 修正されたサイズを返します。

pHeight [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_INVALIDCALL、D3DERR_NOTAVAILABLE。

解説

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

この関数は、要求された要件を使用可能な形式と比較するときに、次のヒューリスティックを使用します。

• チャネル数が少ない形式は選択しないでください。
• 明示的に要求されない限り、 FOURCC および 24 ビット形式は使用しないでください。
• 新しいチャネルを追加しないようにしてください。
• チャネルあたりのビット数を変更しないようにしてください。
• 形式の種類間で変換しないようにしてください。 たとえば、ARGB 形式を深度形式に変換しないでください。

必要条件

関連項目

D3DX 9 のテクスチャ関数