共用方式為


drvAssertMode 函式 (winddi.h)

DrvAssertMode 函式會將指定實體裝置的模式設定為 PDEV 初始化時所指定的模式,或設定為硬體的預設模式。

語法

BOOL DrvAssertMode(
  [in] DHPDEV dhpdev,
  [in] BOOL   bEnable
);

參數

[in] dhpdev

PDEV 的句柄,描述 bEnableTRUE 時應設定的硬體模式。

[in] bEnable

指定要設定硬體的模式。 如果此參數為 TRUE,驅動程式應該將硬體設定為初始化 PDEV 所指定的原始模式。 否則,如果此參數為 FALSE,驅動程式應該將硬體設定為其預設模式,讓視訊迷你埠驅動程式可以假設有控制權。

傳回值

如果DrvAssertMode成功變更顯示模式,DrvAssertMode 會傳回 TRUE ;如果無法變更顯示模式,則會傳回 FALSE 。 允許驅動程式從DrvAssertMode呼叫傳回 FALSE,並將 bEnable 設為 FALSE。 驅動程序必須從DrvAssertMode呼叫傳回TRUE且 bEnable 設為 TRUE;也就是說,驅動程式無法啟用先前啟用的模式。

備註

GDI 需要在單一顯示介面上的多個桌面之間切換時,呼叫 DrvAssertMode 。 若要從一個 PDEV 切換到另一個 PDEV,GDI 會呼叫 DrvAssertMode ,並將 bEnable 參數設定為 FALSE ,另一個則呼叫 TRUE 。 若要還原為原始 PDEV, 系統會呼叫DrvAssertMode並將 bEnable 設定為 FALSE,然後再呼叫 DrvAssertMode,並將 bEnable 設定為 TRUE ,並將 dhpdev 設定為原始 PDEV。

如果實體裝置受調色盤管理,GDI 會呼叫 DrvSetPalette 來重設裝置的調色盤。 驅動程式接著不需要追蹤目前的指標狀態,因為視窗管理員會選取正確的指標圖形,並將它移至目前的位置。 主控台管理員可確保桌面已正確重新繪製。

DrvAssertMode 必須在顯示驅動程式中實作。

規格需求

需求
目標平台 桌面
標頭 winddi.h (包含Winddi.h)

另請參閱

DrvGetModes

DrvSetPalette