IDirect3D9::CheckDeviceType メソッド

[アーティクル]
04/22/2010

IDirect3D9::CheckDeviceType メソッド

アダプタでハードウェアアクセラレーションデバイスタイプが使用可能かどうかを検証する。

構文

HRESULT CheckDeviceType(      
    UINT Adapter,
    D3DDEVTYPE DeviceType,
    D3DFORMAT DisplayFormat,
    D3DFORMAT BackBufferFormat,
    BOOL Windowed
);

パラメータ

Adapter
[in] 列挙するディスプレイアダプタを示す序数。D3DADAPTER_DEFAULT は常にプライマリディスプレイアダプタである。この値がシステムのディスプレイアダプタの数以上の場合、このメソッドは D3DERR_INVALIDCALL を返す。
DeviceType
[in] D3DDEVTYPE 列挙型のメンバ。チェックするデバイスタイプを示す。
DisplayFormat
[in] D3DFORMAT 列挙型のメンバ。デバイスタイプをチェックするアダプタディスプレイモードのフォーマットを示す。たとえば、デバイスによっては、ピクセル単位の 16 ビットのモードでのみ動作するものもある。
BackBufferFormat
[in] バックバッファフォーマット。フォーマットの詳細については、「D3DFORMAT」を参照すること。この値は、レンダリングターゲットフォーマットの 1 つでなければならない。現在のフォーマットは、IDirect3DDevice9::GetDisplayMode を使って取得できる。

ウィンドウアプリケーションでは、ハードウェアが色変換をサポートしている場合、バックバッファフォーマットがディスプレイモードフォーマットと必ずしも一致する必要はない。使用可能なバックバッファフォーマットのセットは制限されているが、ランタイムは任意の有効なバックバッファフォーマットを使って、任意のデスクトップフォーマットにプレゼンテーションできる。ただし、デバイスがデスクトップモードで動作可能でなければならないという要件もある。通常、デバイスはピクセルあたり 8 ビットのモードでは動作しない。

フルスクリーンアプリケーションでは、色変換を実行できない。

D3DFMT_UNKNOWN は、ウィンドウモードで使える。
Windowed
[in] デバイスタイプがフルスクリーンモードとウィンドウモードのどちらで使われるかを示す値。TRUE を設定した場合、ウィンドウアプリケーションの問い合わせが実行される。それ以外の場合は、この値に FALSE する必要がある。

戻り値

このアダプタでデバイスを使える場合は、D3D_OK を返す。

Adapter がシステムのディスプレイアダプタの数以上の場合は、D3DERR_INVALIDCALL を返す。IDirect3D9::CheckDeviceType が存在しないデバイスを指定していた場合も、D3DERR_INVALIDCALL を返す。

要求したバックバッファフォーマットがサポートされていないか、指定したフォーマットでハードウェアアクセラレーションが使えない場合は、D3DERR_NOTAVAILABLE を返す。

注意

デバイス型ハードウェアアブストラクションレイヤ (HAL) にはハードウェアアクセラレーションが必要である。アプリケーションでは、CheckDeviceType を使って HAL デバイスのサポートに必要なハードウェアおよびドライバがあるかどうかを確認できる。

フルスクリーンアプリケーションでは、アルファチャンネルを含む DisplayFormat を指定すべきではない。この場合、呼び出しは失敗する。バックバッファにアルファチャンネルが存在してもよいが、2 つのディスプレイフォーマットは他のすべての面で同じでなければならない。たとえば、DisplayFormat が D3DFMT_X1R5G5B5 の場合、BackBufferFormat の有効な値には D3DFMT_X1R5G5B5 および D3DFMT_A1R5G5B5 は含まれるが、D3DFMT_R5G6B5 は除外される。

次のサンプルコードは、CheckDeviceType を使って、特定のデバイスタイプをそのアダプタで使えるかどうかを確認する方法を示している。

if(SUCCEEDED(pD3Device->CheckDeviceType(D3DADAPTER_DEFAULT, 
                                        D3DDEVTYPE_HAL, 
                                        DisplayFormat, 
                                        BackBufferFormat, 
                                        bIsWindowed)))

     return S_OK;
// There is no HAL on this adapter using this render target format. 
// Try again, using another format.

デバイスがデフォルトのアダプタ上で、指定されたサーフェイスフォーマットで使える場合、このコードは S_OK を返す。

IDirect3D9::CheckDeviceType を使って、ディスプレイフォーマットと異なるバックバッファとの互換性をテストすると、適切な値が返される。つまり、呼び出しはデバイスの能力を表す。要求したバックバッファフォーマットにデバイスがレンダリングできない場合でも、呼び出しは D3DERR_NOTAVAILABLE を返す。デバイスがそのフォーマットにレンダリングできるが、色変換を使ったプレゼンテーションを実行できない場合も、戻り値は D3DERR_NOTAVAILABLE になる。アプリケーションでは、IDirect3D9::CheckDeviceFormatConversion を呼び出してプレゼンテーション自体のハードウェアサポートを検出できる。色変換を使ったプレゼンテーション自体のソフトウェアエミュレーションは提供されない。

IDirect3D9::CheckDeviceType メソッド

IDirect3D9::CheckDeviceType メソッド

その他のリソース