Struttura DRVENABLEDATA (winddi.h)

Articolo
03/13/2024

La struttura DRVENABLEDATA contiene un puntatore a una matrice di strutture DRVFN e il numero di versione DDI grafica di un sistema operativo basato su NT.

Sintassi

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

Members

iDriverVersion

Specifica il numero di versione DDI grafica del sistema operativo basato su NT a cui è destinato il driver. Questo membro può essere impostato su uno dei valori seguenti:

Valore	Versione del sistema operativo
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

Per altre informazioni, vedere la sezione Osservazioni.

c

Specifica il numero di strutture DRVFN nel buffer a cui punta il membro pdrvfn .

pdrvfn

Puntatore a un buffer contenente una matrice di strutture DRVFN .

Commenti

Per l'esecuzione in queste versioni dei sistemi operativi basati su NT, il membro iDriverVersion deve essere impostato come segue:

Versione di Windows	Valore di 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

Come illustrato nella tabella, un driver può essere eseguito in una di queste versioni del sistema operativo se iDriverVersion è impostato su DDI_DRIVER_VERSION_NT4, ma un driver può essere eseguito solo in Windows XP e versioni successive del sistema operativo se iDriverVersion è impostato su DDI_DRIVER_VERSION_NT5_01.

Nota Se un driver implementa un DDI di grafica DrvXxx non supportato in tutte le versioni di Windows, il driver non può specificare una voce DRVFN per tale DDI grafica durante l'esecuzione in versioni di Windows che non lo supportano. Se il driver specifica una voce DRVFN per tale DDI grafica, Windows rifiuterà il driver. L'esempio permedia2 illustra come specificare strutture DRVFN diverse per versioni diverse di Windows.

Requisiti

Requisito	Valore
Intestazione	winddi.h (include Winddi.h)

Vedi anche

DRVFN

DrvEnableDriver

Condividi tramite