Platform SDK: DirectX

D3DXCheckTextureRequirements

D3DXCheckTextureRequirements 関数は、テクスチャ作成に関する情報を返す。この関数を使用すれば、Direct3DDevice カレント デバイスで機能している最も近いサーフェス タイプを簡単に判定できる。理想のテクスチャのフォーマット、幅、高さ、およびミップマップ フラグを指定すると、選択したデバイスで機能している最も近いサーフェス タイプが返される。

HRESULT D3DXCheckTextureRequirements(
  LPDIRECT3DDEVICE7 pd3dDevice,
  LPDWORD pFlags,
  LPDWORD pWidth,
  LPDWORD pHeight,
  D3DX_SURFACEFORMAT* pPixelFormat,
);

パラメータ

pd3dDevice
テクスチャに関連付けられている Direct3D デバイスの IDirect3DDevice7 インターフェイスへのポインタ。
pFlags
DWORD 値へのポインタ。ミップマップを生成しない場合、このパラメータにより D3DX_TEXTURE_NOMIPMAP フラグを指定する。この値に、NULL を指定することも可能である。ミップマップ生成がサポートされていない場合は、D3DX_TEXTURE_NOMIPMAP フラグが返される。
pWidth
幅を示す DWORD 値へのポインタ (ピクセル単位)。0 または D3DX_DEFAULT を指定した場合、幅はファイルから取得される。このパラメータは、補正された幅を返す。
pHeight
高さを示す DWORD 値へのポインタ (ピクセル単位)。0 または D3DX_DEFAULT を指定した場合、高さはファイルから取得される。このパラメータは、補正された高さを返す。
pPixelFormat
D3DX_SURFACEFORMAT 列挙型のメンバへのポインタ。このパラメータの入力値は、適切なテクスチャ フォーマットである。戻り値は、ハードウェアでサポートされている最も近いテクスチャ フォーマットである。

戻り値

成功すれば、S_OK を返す。

失敗すれば、次いずれかの値を返す。

D3DXERR_INVALIDPARAMETER
D3DXERR_NOMATCHFOUND
D3DXERR_NULLPOINTER

注意

この関数は、D3DXCreateTexture 関数、D3DXCreateTextureFromFile 関数、および D3DXCreateCubeMapTexture 関数で必要なサイズ変更やフォーマット変換を判定するときに役に立つ。ほとんどの場合、この手順を実行しなくても作成関数を直接使用できる。

動作環境

  Windows NT/2000 : Windows 2000 が必要。
  Windows 95/98 : Windows 95 以上が必要。Windows 95 用に再配布可能な形で使用可能。
  バージョン : DirectX 7.0 が必要。
  ヘッダー : d3dxcore.h で宣言。
  ライブラリ : d3dx.lib を使用。