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。 當硬體不支援兩種格式之間的轉換時，此方法會傳回D3DERR_NOTAVAILABLE。

備註

使用 CheckDeviceType 來測試與顯示格式不同的後端緩衝區之間的相容性，將會傳回適當的值。 這表示呼叫會反映裝置功能。 如果裝置無法轉譯為所要求的後端緩衝區格式，呼叫仍會傳回D3DERR_NOTAVAILABLE。 如果裝置可以轉譯為格式，但無法執行色彩轉換簡報，則傳回值也會D3DERR_NOTAVAILABLE。 應用程式可以藉由呼叫 CheckDeviceFormatConversion 來探索簡報本身的硬體支援。 不會提供色彩轉換簡報本身的軟體模擬。

CheckDeviceFormatConversion 也可以用來判斷呼叫 StretchRect 時允許來源介面格式和目的地介面格式的組合。

色彩轉換僅限於下列來源和目標格式。

• 來源格式必須是FOURCC格式或有效的後台緩衝區格式。 如需這些清單，請參閱 FourCC Formats 和 BackBuffer 或 Display Formats。
• 目標格式必須是下列其中一個未帶正負號的格式：

  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)
程式庫	D3D9.lib

另請參閱

ColorFill

IDirect3D9