IDirect3D9::CheckDeviceFormat メソッド

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

IDirect3D9::CheckDeviceFormat メソッド

サーフェイスのフォーマットが、指定したリソースタイプとして利用できるかどうか、およびこのアダプタを使うデバイスでテクスチャ、深度ステンシルバッファ、レンダリングターゲットのいずれか、またはこれら 3 つの組み合わせとして使えるかどうかを調べる。

構文

HRESULT CheckDeviceFormat(      
    UINT Adapter,
    D3DDEVTYPE DeviceType,
    D3DFORMAT AdapterFormat,
    DWORD Usage,
    D3DRESOURCETYPE RType,
    D3DFORMAT CheckFormat
);

パラメータ

Adapter
[in] 問い合わせ対象のディスプレイアダプタを示す序数。D3DADAPTER_DEFAULT は常にプライマリディスプレイアダプタである。この値がシステムのディスプレイアダプタの数以上の場合、このメソッドは D3DERR_INVALIDCALL を返す。
DeviceType
[in] D3DDEVTYPE 列挙型のメンバ。デバイスタイプを識別する。
AdapterFormat
[in] D3DFORMAT 列挙型のメンバ。アダプタで使われるディスプレイモードのフォーマットを識別する。
Usage
[in] サーフェイスに対して要求する使用方法オプション。使用方法オプションは、D3DUSAGE および D3DUSAGE_QUERY 定数の任意の組み合わせである (CheckDeviceFormat に対しては D3DUSAGE 定数のサブセットのみが有効。「D3DUSAGE」にある表を参照すること)。
RType
[in] 問い合わせ対象のフォーマットで使うことを要求するリソースタイプ。D3DRESOURCETYPE のメンバ。
CheckFormat
[in] Usage で指定した方法で使うサーフェイスのフォーマットを示す。D3DFORMAT のメンバ。

戻り値

フォーマットが、要求された使用方法について、指定されたデバイスと互換性がある場合、このメソッドは D3D_OK を返す。

Adapter がシステムのディスプレイアダプタの数以上の場合、または DeviceType がサポートされていない場合、このメソッドは D3DERR_INVALIDCALL を返す。フォーマットがこの使用方法ではデバイスで受け入れられない場合、このメソッドは D3DERR_NOTAVAILABLE を返す。

注意

アプリケーションは、IDirect3D9::CheckDeviceFormat に D3DUSAGE_AUTOGENMIPMAP を指定して呼び出して、特定のフォーマットに対する自動生成のサポートを検出できる。ミップマップ自動生成の要求は、ヒントと見なされる。したがって、このメソッドは DDOK_NOAUTOGEN を返すことができる。ミップマップの生成のみに失敗した場合、この値は有効な成功コードである。ミップマップの自動生成が失敗した場合、アプリケーションはミップマップ化されていないテクスチャを受け取る。詳細については、「ミップマップの自動生成」を参照すること。

オフスクリーンの単純なプレーンサーフェイスフォーマットについて調べるには、Usage = 0 および RType = RTYPE_SURFACE を指定する。

IDirect3D9::CheckDeviceFormat の一般的な用途は、特定の深度ステンシルサーフェイスフォーマットが存在するかどうかを確認することである。列挙処理の詳細については、「デバイスの選択」を参照すること。次のサンプルコードは、IDirect3D9::CheckDeviceFormat を使って深度ステンシルフォーマットの有無を確認する方法を示している。

BOOL IsDepthFormatExisting( D3DFORMAT DepthFormat, D3DFORMAT AdapterFormat ) 
{
    HRESULT hr = pD3D->CheckDeviceFormat( D3DADAPTER_DEFAULT,
                                          D3DDEVTYPE_HAL,
                                          AdapterFormat,
                                          D3DUSAGE_DEPTHSTENCIL,
                                          D3DRTYPE_SURFACE,
                                          CheckFormat);

    return SUCCEEDED( hr );
}

上の呼び出しは、システムに CheckFormat が存在しない場合は FALSE を返す。

IDirect3D9::CheckDeviceFormat のもう 1 つの一般的な用途は、特定のサーフェイスフォーマットに存在するテクスチャを、現在のディスプレイモードでレンダリングできるかどうかを確認することである。次のサンプルコードは、IDirect3D9::CheckDeviceFormat を使って、テクスチャフォーマットが特定のバックバッファフォーマットと互換性があるかどうかを確認する方法を示している。

BOOL IsTextureFormatOk( D3DFORMAT TextureFormat, D3DFORMAT AdapterFormat ) 
{
    HRESULT hr = pD3D->CheckDeviceFormat( D3DADAPTER_DEFAULT,
                                          D3DDEVTYPE_HAL,
                                          AdapterFormat,
                                          0,
                                          D3DRTYPE_TEXTURE,
                                          CheckFormat);

    return SUCCEEDED( hr );
}

上の呼び出しは、アダプタサーフェイスフォーマットが AdapterFormat であるときに、CheckFormat を使ってテクスチャをレンダリングできない場合、FALSE を返す。

次の方法で共有

IDirect3D9::CheckDeviceFormat メソッド

IDirect3D9::CheckDeviceFormat メソッド

その他のリソース