estructura de WDF_DRIVER_CONFIG (wdfdriver.h)

Artículo
03/05/2024

[Se aplica a KMDF y UMDF]

La estructura WDF_DRIVER_CONFIG es un parámetro de entrada para WdfDriverCreate.

Sintaxis

typedef struct _WDF_DRIVER_CONFIG {
  ULONG                     Size;
  PFN_WDF_DRIVER_DEVICE_ADD EvtDriverDeviceAdd;
  PFN_WDF_DRIVER_UNLOAD     EvtDriverUnload;
  ULONG                     DriverInitFlags;
  ULONG                     DriverPoolTag;
} WDF_DRIVER_CONFIG, *PWDF_DRIVER_CONFIG;

Miembros

Size

Tamaño, en bytes, de esta estructura.

EvtDriverDeviceAdd

Puntero a la función de devolución de llamada EvtDriverDeviceAdd de un controlador.

EvtDriverUnload

Puntero a la función de devolución de llamada EvtDriverUnload de un controlador.

DriverInitFlags

OR bit a bit de uno o varios valores con tipo WDF_DRIVER_INIT_FLAGS que identifican las marcas de inicialización del controlador.

DriverPoolTag

(VERSIONES 1.5 y posteriores de KMDF). Una etiqueta de grupo definida por el controlador que el marco asignará a todas las asignaciones del grupo de controladores. Los depuradores muestran esta etiqueta. Para obtener más información sobre cómo especificar una etiqueta de grupo, consulte la siguiente sección Comentarios.

Comentarios

Opcionalmente, el controlador puede especificar una etiqueta de grupo que el marco asignará a todas las asignaciones del grupo de controladores. Normalmente, los controladores especifican una cadena de caracteres de hasta cuatro caracteres, delimitados por comillas simples, en orden inverso (por ejemplo, "dcba"). El valor ASCII de cada carácter de la etiqueta debe estar comprendido entre 0 y 127.

Si DriverPoolTag es cero, el marco crea una etiqueta de grupo predeterminada mediante los cuatro primeros caracteres del nombre del servicio en modo kernel del controlador. Si el nombre del servicio comienza por "WDF" (el nombre no distingue mayúsculas de minúsculas y no incluye las comillas), se usan los cuatro caracteres siguientes. Si hay menos de cuatro caracteres disponibles, se usa "FxDr".

Para inicializar una estructura de WDF_DRIVER_CONFIG, los controladores deben llamar a WDF_DRIVER_CONFIG_INIT.