Funzione DrvAssertMode (winddi.h)

  • Articolo

La funzione DrvAssertMode imposta la modalità del dispositivo fisico specificato sulla modalità specificata quando il PDEV è stato inizializzato o sulla modalità predefinita dell'hardware.

Sintassi

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

Parametri

[in] dhpdev

Handle per pdev che descrive la modalità hardware che deve essere impostata quando bEnable è TRUE.

[in] bEnable

Specifica la modalità in cui impostare l'hardware. Se questo parametro è TRUE, il driver deve impostare l'hardware sulla modalità originale specificata dal PDEV inizializzato. In caso contrario, se questo parametro è FALSE, il driver deve impostare l'hardware sulla modalità predefinita in modo che il driver miniport video possa assumere il controllo.

Valore restituito

DrvAssertMode restituisceTRUE se è stata modificata correttamente la modalità di visualizzazione; restituisce FALSE se non è stato possibile modificare la modalità di visualizzazione. Un driver può restituire FALSE da una chiamata DrvAssertMode con bEnable impostato su FALSE. Un driver deve restituire TRUE da una chiamata DrvAssertMode con bEnable impostato su TRUE; ovvero, un driver non può avere esito negativo abilitando una modalità abilitata in precedenza.

Commenti

GDI chiama DrvAssertMode quando è necessario passare tra più desktop su una singola superficie di visualizzazione. Per passare da un PDEV a un altro, GDI chiama DrvAssertMode con il parametro bEnable impostato su FALSE per un PDEV e TRUE per l'altro. Per ripristinare il PDEV originale, DrvAssertMode viene chiamato con bEnable impostato su FALSE, seguito da un'altra chiamata a DrvAssertMode, con bEnable impostato su TRUE e dhpdev impostato sul PDEV originale.

Se il dispositivo fisico è gestito dalla tavolozza, GDI chiamerà DrvSetPalette per reimpostare la tavolozza del dispositivo. Il driver non deve quindi tenere traccia dello stato del puntatore corrente perché Window Manager seleziona la forma del puntatore corretta e lo sposta nella posizione corrente. Gestione console garantisce che i desktop vengano ridisegnati correttamente.

DrvAssertMode deve essere implementato nei driver di visualizzazione.

Requisiti

Requisito Valore
Piattaforma di destinazione Desktop
Intestazione winddi.h (include Winddi.h)

Vedi anche

DrvGetModes

DrvSetPalette