drvAssertMode 函式 (winddi.h)
DrvAssertMode 函式會將指定實體裝置的模式設定為 PDEV 初始化時所指定的模式,或設定為硬體的預設模式。
語法
BOOL DrvAssertMode(
[in] DHPDEV dhpdev,
[in] BOOL bEnable
);
參數
[in] dhpdev
PDEV 的句柄,描述 bEnable 為 TRUE 時應設定的硬體模式。
[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) |