Struttura DRVENABLEDATA (winddi.h)

  • Articolo

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