Freigeben über

DrvAssertMode-Funktion (winddi.h)

  • Artikel

Die DrvAssertMode-Funktion legt den Modus des angegebenen physischen Geräts entweder auf den Modus fest, der bei der Initialisierung des PDEV angegeben wurde, oder auf den Standardmodus der Hardware.

Syntax

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

Parameter

[in] dhpdev

Handle mit dem PDEV, der den Hardwaremodus beschreibt, der festgelegt werden soll, wenn bEnableTRUE ist.

[in] bEnable

Gibt den Modus an, in den die Hardware festgelegt werden soll. Wenn dieser Parameter TRUE ist, sollte der Treiber die Hardware auf den ursprünglichen Modus festlegen, der vom initialisierten PDEV angegeben wird. Andernfalls sollte der Treiber, wenn dieser Parameter FALSE ist, die Hardware auf den Standardmodus festlegen, damit der Videominiporttreiber die Steuerung übernehmen kann.

Rückgabewert

DrvAssertMode gibt TRUE zurück, wenn der Anzeigemodus erfolgreich geändert wurde. Es gibt FALSE zurück, wenn der Anzeigemodus nicht geändert werden konnte. Ein Treiber darf FALSE von einem DrvAssertMode-Aufruf zurückgeben, wobei bEnable auf FALSE festgelegt ist. Ein Treiber muss true von einem DrvAssertMode-Aufruf zurückgeben, wobei bEnable auf TRUE festgelegt ist. Das heißt, ein Treiber kann bei der Aktivierung eines zuvor aktivierten Modus nicht fehlschlagen.

Hinweise

GDI ruft DrvAssertMode auf, wenn es erforderlich ist, zwischen mehreren Desktops auf einer einzelnen Anzeigeoberfläche zu wechseln. Um von einem PDEV zu einem anderen zu wechseln, ruft GDI DrvAssertMode auf, wobei der bEnable-Parameter für einen PDEV auf FALSE und true für den anderen festgelegt ist. Um den ursprünglichen PDEV zu rückgängig machen, wird DrvAssertMode aufgerufen, wobei bEnable auf FALSE festgelegt ist, gefolgt von einem weiteren Aufruf von DrvAssertMode, wobei bEnable auf TRUE und dhpdev auf den ursprünglichen PDEV festgelegt ist.

Wenn das physische Gerät palettenseitig verwaltet wird, ruft GDI DrvSetPalette auf, um die Palette des Geräts zurückzusetzen. Der Treiber muss dann den aktuellen Zeigerzustand nicht nachverfolgen, da der Fenster-Manager die richtige Zeigerform auswählt und an die aktuelle Position verschiebt. Der Konsolen-Manager stellt sicher, dass Desktops ordnungsgemäß neu gezeichnet werden.

DrvAssertMode muss in Anzeigetreibern implementiert werden.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile winddi.h (einschließlich Winddi.h)

Weitere Informationen

DrvGetModes

DrvSetPalette