共用方式為


IDirect3D9Ex::GetAdapterDisplayModeEx 方法 (d3d9.h)

擷取介面卡目前的顯示模式和旋轉設定。

語法

HRESULT GetAdapterDisplayModeEx(
  [in]      UINT               Adapter,
  [in, out] D3DDISPLAYMODEEX   *pMode,
  [in, out] D3DDISPLAYROTATION *pRotation
);

參數

[in] Adapter

類型: UINT

表示要查詢之顯示配接器的序號。 D3DADAPTER_DEFAULT一律是主要顯示配接器。

[in, out] pMode

類型: D3DDISPLAYMODEEX*

D3DDISPLAYMODEEX結構的指標,其中包含配接器顯示模式的相關資料。 與裝置的顯示模式相反,如果裝置沒有全螢幕模式,則可能無法使用。 可以設定為 Null

[in, out] pRotation

類型: D3DDISPLAYROTATION*

D3DDISPLAYROTATION結構的指標,指出應用程式將執行的螢幕旋轉類型。 使用 D3DPRESENTFLAG_NOAUTOROTATE 旗標時,透過這個指標傳回的值很重要;否則,它可以設定為 Null

傳回值

類型: HRESULT

如果方法成功,傳回值會D3D_OK。

如果 Adapter 超出範圍或 pMode 無效,此方法會傳回D3DERR_INVALIDCALL。

備註

GetAdapterDisplayModeEx 在顯示格式為擴充格式時不會傳回正確的格式,例如 2:10:10:10。 相反地,它會傳回 X8R8G8B8 格式。

若要視窗化應用程式, 從 PresentExCheckDeviceState 傳回的S_PRESENT_MODE_CHANGED值表示顯示模式已變更,而且目前的顯示模式可能有不同的格式。 為了避免色彩轉換 Present blt,視窗化應用程式可以選擇性地使用此方法取得新的顯示模式資訊,並據以調整其交換鏈結格式。 這個方法會傳回D3DERR_NOTAVAILABLE,如果此前端不再是桌面的一部分,或如果監視器已中斷連線,則傳回 。

需求

   
目標平台 Windows
標頭 d3d9.h
程式庫 D3D9.lib

另請參閱

IDirect3D9Ex