estructura de WDF_DRIVER_CONFIG (wdfdriver.h)
[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.
Requisitos
| Requisito | Value |
|---|---|
| Versión mínima de KMDF | 1.0 |
| Versión mínima de UMDF | 2.0 |
| Encabezado | wdfdriver.h (incluya Wdf.h) |