Funzione DrvGetModes (winddi.h)

Articolo
08/27/2023

La funzione DrvGetModes elenca le modalità supportate da un determinato dispositivo.

Sintassi

ULONG DrvGetModes(
  [in]            HANDLE   hDriver,
                  ULONG    cjSize,
  [out, optional] DEVMODEW *pdm
);

Parametri

[in] hDriver

Gestire il driver per cui è necessario enumerare le modalità. Questo è l'handle passato nel parametro hDriver della funzione DrvEnablePDEV .

cjSize

Specifica le dimensioni in byte del buffer a cui fa riferimento pdm.

[out, optional] pdm

Puntatore al buffer contenente le strutture DEVMODEW per il driver da compilare o NULL.

Valore restituito

Il driver deve restituire il numero di byte scritti nel buffer se pdm non è NULL. Se pdm è NULL, il driver deve restituire il numero di byte necessari per contenere tutti i dati in modalità. Il driver deve restituire zero se si verifica un errore.

Commenti

Questa funzione deve essere implementata in tutti i driver di visualizzazione.

Window Manager carica dinamicamente tutti i driver di visualizzazione associati a un driver miniport (in base alla chiave InstalledDisplayDrivers nel Registro di sistema). Ogni driver di visualizzazione viene chiamato per recuperare l'elenco delle modalità supportate da tale combinazione di driver caricati. Ad esempio, il driver di visualizzazione VGA64K restituisce solo le modalità di colore 64K restituite nell'elenco delle modalità ottenute dal driver miniport.

DrvGetModes può essere chiamato prima che esista un PDEV attivo.

Vedere gli esempi di Permedia per visualizzare un'implementazione funzionante di DrvGetModes.

Nota Microsoft Windows Driver Kit (WDK) non contiene i driver di visualizzazione di esempio 3Dlabs Permedia2 (3dlabs.htm ) e 3Dlabs Permedia3 (Perm3.htm). È possibile ottenere questi driver di esempio dalla pagina Windows Server 2003 SP1 Driver Development Kit (DDK), che è possibile scaricare dalla pagina DDK - Windows Driver Development Kit del sito Web WDHC.