Partager via


STRUCTURE DRVENABLEDATA (winddi.h)

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