IDirect3D9::CheckDeviceFormatConversion メソッド (d3d9.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
ヘッダー	d3d9.h (D3D9.h を含む)
Library	D3D9.lib

こちらもご覧ください

ColorFill

IDirect3D9