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 格式。
若要視窗化應用程式, 從 PresentEx 或 CheckDeviceState 傳回的S_PRESENT_MODE_CHANGED值表示顯示模式已變更,而且目前的顯示模式可能有不同的格式。 為了避免色彩轉換 Present blt,視窗化應用程式可以選擇性地使用此方法取得新的顯示模式資訊,並據以調整其交換鏈結格式。 這個方法會傳回D3DERR_NOTAVAILABLE,如果此前端不再是桌面的一部分,或如果監視器已中斷連線,則傳回 。
需求
目標平台 | Windows |
標頭 | d3d9.h |
程式庫 | D3D9.lib |