Microsoft DirectX 8.0 (C++)

D3DXCheckTextureRequirements

テクスチャ作成パラメータを確認する。

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

パラメータ

pDevice
[in] テクスチャに関連付けられているデバイスを表す IDirect3DDevice8 インターフェイスへのポインタ。
pWidth
[in, out] 要求される幅 (ピクセル単位) へのポインタ、または NULL。訂正後のサイズを返す。
pHeight
[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 を返す。

失敗した場合は、次のいずれかの値を返す。

D3DERR_NOTAVAILABLE
D3DERR_INVALIDCALL

注意

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

動作環境

  ヘッダー : D3dx8tex.h で宣言。
  インポート ライブラリ : D3dx8.lib を使用。