Estructura DRVENABLEDATA (winddi.h)

La estructura DRVENABLEDATA contiene un puntero a una matriz de estructuras DRVFN y el número de versión de DDI de gráficos de un sistema operativo basado en NT.

Sintaxis

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

Miembros

iDriverVersion

Especifica el número de versión de DDI de gráficos del sistema operativo basado en NT para el que está destinado el controlador. Este miembro se puede establecer en uno de los valores siguientes:

Valor	Versión de 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

 

Vea la sección Comentarios para obtener más información.

c

Especifica el número de estructuras DRVFN en el búfer al que apunta el miembro pdrvfn .

pdrvfn

Puntero a un búfer que contiene una matriz de estructuras DRVFN .

Comentarios

Para ejecutarse en estas versiones de sistemas operativos basados en NT, el miembro iDriverVersion debe establecerse de la siguiente manera:

Versión de Windows	Valor de 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

 

Como se muestra en la tabla, un controlador puede ejecutarse en cualquiera de estas versiones del sistema operativo si iDriverVersion está establecido en DDI_DRIVER_VERSION_NT4, pero un controlador solo se puede ejecutar en Windows XP y versiones posteriores del sistema operativo si iDriverVersion está establecido en DDI_DRIVER_VERSION_NT5_01.

Nota Si un controlador implementa un DDI de gráficos DrvXxx que no se admite en todas las versiones de Windows, el controlador no puede especificar una entrada DRVFN para ese DDI de gráficos cuando se ejecuta en versiones de Windows que no lo admiten. Si el controlador especifica una entrada DRVFN para este tipo de DDI de gráficos, Windows rechazará el controlador. En el ejemplo permedia2 se muestra cómo especificar diferentes estructuras DRVFN para diferentes versiones de Windows.

 

Requisitos

Requisito	Valor
Header	winddi.h (incluya Winddi.h)

Consulte también

DRVFN

DrvEnableDriver