Share via

IDirect3D9：：EnumAdapterModes 方法 (d3d9.h)

  • 發行項

查詢裝置，以判斷指定的配接器是否支援所要求的格式和顯示模式。 這個方法可用於 迴圈，以列舉所有可用的配接器模式。

語法

HRESULT EnumAdapterModes(
  [in]  UINT           Adapter,
  [in]  D3DFORMAT      Format,
  [in]  UINT           Mode,
  [out] D3DDISPLAYMODE *pMode
);

參數

[in] Adapter

類型： UINT

表示要列舉之顯示配接器的序數。 D3DADAPTER_DEFAULT 一律是主要顯示配接器。 當這個值等於或超過系統中的顯示配接器數目時，這個方法會傳回D3DERR_INVALIDCALL。

[in] Format

類型： D3DFORMAT

允許的像素格式。 請參閱＜備註＞。

[in] Mode

類型： UINT

表示顯示模式索引，這是零與 GetAdapterModeCount 減一所傳回之值之間的不帶正負號整數。

[out] pMode

類型： D3DDISPLAYMODE*

D3DDISPLAYMODE類型的可用顯示模式指標。 請參閱＜備註＞。

傳回值

類型： HRESULT

  • 如果此介面卡可以使用裝置，則會傳回D3D_OK。
  • 如果配接器等於或超過系統中的顯示配接器數目，則會傳回D3DERR_INVALIDCALL。
  • 如果不支援表面格式，或如果硬體加速不適用於指定的格式，則會傳回D3DERR_NOTAVAILABLE。

備註

應用程式會提供顯示模式和 EnumAdapterModes 的格式，以傳回顯示模式。 這個方法可用於 迴圈，以列舉所有可用的顯示模式。

應用程式會指定格式，而且列舉僅限於完全符合 Alpha 格式 (的顯示模式，) 忽略 Alpha 格式。 允許的格式 (D3DFORMAT) 的成員如下：

  • D3DFMT_A1R5G5B5
  • D3DFMT_A2R10G10B10
  • D3DFMT_A8R8G8B8
  • D3DFMT_R5G6B5
  • D3DFMT_X1R5G5B5
  • D3DFMT_X8R8G8B8
此外， EnumAdapterModes 會將像素格式 565 和 555 視為相等，並傳回正確的版本。 只有在應用程式鎖定上一個緩衝區，而且應用程式必須設定明確旗標才能完成此動作時，才會有差異。

需求

   
目標平台 Windows
標頭 d3d9.h (包含 D3D9.h)
程式庫 D3D9.lib

另請參閱

IDirect3D9