IDirect3D9::GetDeviceCaps

  • [アーティクル]

デバイスについてのデバイス固有の情報を取得します。

HRESULT 
GetDeviceCaps(
  UINT Adapter,
  D3DDEVTYPE DeviceType,
  D3DCAPS9 * pCaps
);

パラメータ

  • Adapter
    ディスプレイ アダプターを示す序数です。D3DADAPTER_DEFAULT は常にプライマリ ディスプレイ アダプターです。
  • DeviceType
    D3DDEVTYPE 列挙型のメンバーです。デバイス タイプを示します。
  • pCaps
    デバイスの機能を説明する情報を格納する D3DCAPS9 構造体へのポインターです。

戻り値

メソッドが成功した場合は、D3D_OK を返します。失敗した場合は、次の戻り値のいずれかを返します。D3DERR_INVALIDCALL、D3DERR_INVALIDDEVICE、D3DERR_OUTOFVIDEOMEMORY、D3DERR_NOTAVAILABLE。

デスクトップがロックされている場合は、D3DERR_NOTAVAILABLE が返されます (つまり、保護されているデスクトップでは Direct3D ドライバーを使用できません)。これにより、アプリケーションは定期的に再試行します。保護されたステータスからデスクトップが戻ったことを検出するには、WM_ACTIVATEAPP メッセージを使用できます。

解説　

アプリケーション側は、Direct3D デバイス オブジェクト全体で頂点処理能力が使用できると仮定すべきではありません。物理的なデバイスが公開する特定の機能は、IDirect3D9::CreateDevice に指定されるパラメーターに応じて異なります。たとえば、ハードウェア頂点処理が有効な Direct3D デバイス オブジェクトを作成する前後では、異なる頂点処理能力を使用できる場合があります。詳細については、「D3DCAPS9」の説明を参照してください。

要件

ヘッダー: D3D9.h 宣言

ライブラリ: D3D9.lib 内容