STRUCTURE DRVENABLEDATA (winddi.h)

Article
03/13/2024

La structure DRVENABLEDATA contient un pointeur vers un tableau de structures DRVFN et le numéro de version DDI graphique d’un système d’exploitation NT.

Syntaxe

typedef struct tagDRVENABLEDATA {
  ULONG iDriverVersion;
  ULONG c;
  DRVFN *pdrvfn;
} DRVENABLEDATA, *PDRVENABLEDATA;

Membres

iDriverVersion

Spécifie le numéro de version DDI graphique du système d’exploitation NT ciblé par le pilote. Ce membre peut être défini sur l’une des valeurs suivantes :

Valeur	Version du système d'exploitation
DDI_DRIVER_VERSION_NT4	Windows NT 4.0
DDI_DRIVER_VERSION_SP3	Windows NT 4.0 Service Pack 3
DDI_DRIVER_VERSION_NT5	Windows 2000
DDI_DRIVER_VERSION_NT5_01	Windows XP
DDI_DRIVER_VERSION_NT5_01_SP1	Windows XP Service Pack 1

Pour plus d'informations, consultez la section Notes.

c

Spécifie le nombre de structures DRVFN dans la mémoire tampon vers laquelle pointe le membre pdrvfn .

pdrvfn

Pointeur vers une mémoire tampon contenant un tableau de structures DRVFN .

Remarques

Pour s’exécuter sur ces versions de systèmes d’exploitation NT, le membre iDriverVersion doit être défini comme suit :

Version de Windows	Valeur d’iDriverVersion
Windows NT 4.0	iDriverVersion == DDI_DRIVER_VERSION_NT4
Windows NT 4.0 SP3	<DDI_DRIVER_VERSION_NT4 = iDriverVersion<= DDI_DRIVER_VERSION_SP3
Windows 2000	<DDI_DRIVER_VERSION_NT4 = iDriverVersion<= DDI_DRIVER_VERSION_NT5
Windows XP	<DDI_DRIVER_VERSION_NT4 = iDriverVersion<= DDI_DRIVER_VERSION_NT5_01
Windows XP SP1	<DDI_DRIVER_VERSION_NT4 = iDriverVersion<= DDI_DRIVER_VERSION_NT5_01_SP1

Comme le montre le tableau, un pilote peut s’exécuter sur l’une de ces versions de système d’exploitation si iDriverVersion est défini sur DDI_DRIVER_VERSION_NT4, mais un pilote peut s’exécuter uniquement sur Windows XP et les versions ultérieures du système d’exploitation si iDriverVersion est défini sur DDI_DRIVER_VERSION_NT5_01.

Note Si un pilote implémente une DDI graphique DrvXxx qui n’est pas prise en charge dans toutes les versions de Windows, le pilote ne peut pas spécifier d’entrée DRVFN pour ce DDI graphique lors de l’exécution sur des versions de Windows qui ne le prennent pas en charge. Si le pilote spécifie une entrée DRVFN pour un tel DDI graphique, Windows rejette le pilote. L’exemple permedia2 montre comment spécifier différentes structures DRVFN pour différentes versions de Windows.

Configuration requise

Condition requise	Valeur
En-tête	winddi.h (inclure Winddi.h)

Voir aussi

DRVFN

DrvEnableDriver

Partager via