共用方式為

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)

另請參閱

DrvGetModes

DrvSetPalette