Fonction DrvGetModes (winddi.h)

Article
03/04/2024

La fonction DrvGetModes répertorie les modes pris en charge par un appareil donné.

Syntaxe

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

Paramètres

[in] hDriver

Gérez le pilote pour lequel les modes doivent être énumérés. Il s’agit du handle passé dans le paramètre hDriver de la fonction DrvEnablePDEV .

cjSize

Spécifie la taille en octets de la mémoire tampon pointée vers pdm.

[out, optional] pdm

Pointeur vers la mémoire tampon contenant la ou les structures DEVMODEW que le pilote doit remplir, ou NULL.

Valeur retournée

Le pilote doit retourner le nombre d’octets écrits dans la mémoire tampon si pdm n’a pas la valeur NULL. Si pdm a la valeur NULL, le pilote doit retourner le nombre d’octets requis pour contenir toutes les données de mode. Le pilote doit retourner zéro si une erreur se produit.

Remarques

Cette fonction doit être implémentée dans tous les pilotes d’affichage.

Window Manager charge dynamiquement tous les pilotes d’affichage associés à un pilote miniport (en fonction de la clé InstalledDisplayDrivers dans le Registre). Chaque pilote d’affichage est appelé pour récupérer la liste des modes pris en charge par cette combinaison de pilotes chargés. Par exemple, le pilote d’affichage VGA64K retourne uniquement les modes de couleur 64K qui ont été retournés dans la liste des modes obtenus à partir du pilote miniport.

DrvGetModes peut être appelé avant qu’un PDEV soit actif.

Reportez-vous aux exemples Permedia pour voir une implémentation opérationnelle de DrvGetModes.

Note Le Kit de pilotes Microsoft Windows (WDK) ne contient pas les exemples de pilotes d’affichage 3Dlabs Permedia2 (3dlabs.htm ) et 3Dlabs Permedia3 (Perm3.htm). Vous pouvez obtenir ces exemples de pilotes à partir du Kit de développement de pilotes (DDK) Windows Server 2003 SP1, que vous pouvez télécharger à partir de la page DDK - Kit de développement de pilotes Windows du site web WDHC.