структура WDF_DRIVER_CONFIG (wdfdriver.h)
[Применимо к KMDF и UMDF]
Структура WDF_DRIVER_CONFIG является входным параметром для WdfDriverCreate.
Синтаксис
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;
Члены
Size
Размер данной структуры (в байтах).
EvtDriverDeviceAdd
Указатель на функцию обратного вызова EvtDriverDeviceAdd драйвера.
EvtDriverUnload
Указатель на функцию обратного вызова EvtDriverUnload драйвера.
DriverInitFlags
Побитовое ИЛИ одного или нескольких WDF_DRIVER_INIT_FLAGS типизированных значений, определяющих флаги инициализации драйвера.
DriverPoolTag
(KMDF версии 1.5 и более поздних.) Определенный драйвером тег пула, который платформа будет назначать всем выделениям пула драйвера. Отладчики отображают этот тег. Дополнительные сведения об указании тега пула см. в следующем разделе Примечаний.
Комментарии
При необходимости драйвер может указать тег пула, который платформа будет назначать всем выделениям пула драйвера. Драйверы обычно указывают строку символов длиной до четырех символов, разделенную одними кавычками, в обратном порядке (например, dcba). Значение ASCII каждого символа в теге должно находиться в диапазоне от 0 до 127.
Если DriverPoolTag равен нулю, платформа создает тег пула по умолчанию, используя первые четыре символа имени службы драйвера в режиме ядра. Если имя службы начинается с "WDF" (имя не учитывает регистр и не содержит кавычки), используются следующие четыре символа. Если доступно менее четырех символов, используется FxDr.
Чтобы инициализировать структуру WDF_DRIVER_CONFIG, драйверы должны вызывать WDF_DRIVER_CONFIG_INIT.
Требования
Требование | Значение |
---|---|
Минимальная версия KMDF | 1,0 |
Минимальная версия UMDF | 2,0 |
Верхняя часть | wdfdriver.h (включая Wdf.h) |