структура 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)

См. также раздел

EvtDriverDeviceAdd

EvtDriverUnload

WDF_DRIVER_CONFIG_INIT

WDF_DRIVER_INIT_FLAGS

WdfDriverCreate