共用方式為


IDirect3D9::EnumAdapterModes 方法 (d3d9helper.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
標頭 d3d9helper.h (包含 D3D9.h)
程式庫 D3D9.lib

另請參閱

IDirect3D9