IDirect3D9::CheckDeviceFormatConversion メソッド (d3d9helper.h)
デバイスをテストして、ある表示形式から別の表示形式への変換がサポートされているかどうかを確認します。
構文
HRESULT CheckDeviceFormatConversion(
[in] UINT Adapter,
[in] D3DDEVTYPE DeviceType,
[in] D3DFORMAT SourceFormat,
[in] D3DFORMAT TargetFormat
);
パラメーター
[in] Adapter
型: UINT
アダプターの序数を表示します。 D3DADAPTER_DEFAULTは常にプライマリ ディスプレイ アダプターです。 このメソッドは、この値がシステム内のディスプレイ アダプターの数と等しいか、または超えたときに、D3DERR_INVALIDCALLを返します。
[in] DeviceType
種類: D3DDEVTYPE
デバイスの種類。 D3DDEVTYPE列挙型のメンバー。
[in] SourceFormat
種類: D3DFORMAT
ソース アダプターの形式。 D3DFORMAT列挙型のメンバー。
[in] TargetFormat
種類: D3DFORMAT
ターゲット アダプターの形式。 D3DFORMAT列挙型のメンバー。
戻り値
型: HRESULT
メソッドが成功した場合、戻り値はD3D_OK。 メソッドが失敗した場合、戻り値はD3DERR_INVALIDCALL。 ハードウェアが 2 つの形式間の変換をサポートしていない場合、メソッドはD3DERR_NOTAVAILABLEを返します。
注釈
CheckDeviceType を使用して、表示形式とは異なるバック バッファー間の互換性をテストすると、適切な値が返されます。 つまり、呼び出しにはデバイスの機能が反映されます。 デバイスが要求されたバック バッファー形式にレンダリングできない場合でも、呼び出しはD3DERR_NOTAVAILABLEを返します。 デバイスが形式にレンダリングできるが、色変換プレゼンテーションを実行できない場合は、戻り値もD3DERR_NOTAVAILABLE。 アプリケーションは、 CheckDeviceFormatConversion を呼び出すことによって、プレゼンテーション自体のハードウェア サポートを検出できます。 色変換プレゼンテーション自体のソフトウェア エミュレーションは提供されません。
CheckDeviceFormatConversion を使用して、 StretchRect の呼び出しで許容されるソース サーフェス形式と変換先サーフェス形式の組み合わせを決定することもできます。
色変換は、次のソースとターゲットの形式に制限されています。
- ソース形式は、FOURCC 形式または有効なバック バッファー形式である必要があります。 これらの一覧については、「 FourCC 形式 」および「BackBuffer」または「表示形式」を参照してください。
- ターゲット形式は、次のいずれかの符号なし形式である必要があります。
D3DFMT_X1R5G5B5 D3DFMT_A1R5G5B5 D3DFMT_R5G6B5 D3DFMT_R8G8B8 D3DFMT_X8R8G8B8 D3DFMT_A8R8G8B8 D3DFMT_A2R10G10B10 D3DFMT_A16B16G16R16 D3DFMT_A2B10G10R10 D3DFMT_A8B8G8R8 D3DFMT_X8B8G8R8 D3DFMT_A16B16G16R16F D3DFMT_A32B32G32R32F
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | d3d9helper.h (D3D9.h を含む) |
| Library | D3D9.lib |