Поделиться через

структура WDFDEVICE_INIT

  • Статья

[Применимо к KMDF и UMDF]

Структура WDFDEVICE_INIT — это непрозрачная структура, определяемая и выделенная платформой.

Синтаксис

struct WDFDEVICE_INIT {
  ;      // Reserved.
};

Участники

Драйверы функций и фильтров получают указатель на эту структуру в качестве входных данных функции обратного вызова EvtDriverDeviceAdd или в качестве возвращаемого значения из WdfControlDeviceInitAllocate.

Драйверы шины получают указатель структуры в качестве входных данных функции обратного вызова EvtChildListCreateDevice или в качестве возвращаемого значения из WdfPdoInitAllocate.

После получения WDFDEVICE_INIT структуры драйвер передает указатель структуры функциям инициализации. Эти функции используют структуру WDFDEVICE_INIT для хранения сведений, используемых платформой для создания объекта устройства платформы.

Сведения о документации по методам инициализации устройств см. в заголовке wdfdevice.h.

После вызова функций инициализации драйвер должен вызвать WdfDeviceCreate , чтобы создать объект устройства платформы.

Если драйвер получил WDFDEVICE_INIT структуру от вызова WdfPdoInitAllocate или WdfControlDeviceInitAllocate, а если драйвер получает ошибку при вызове функции инициализации, драйвер должен вызвать WdfDeviceInitFree вместо WdfDeviceCreate.

Драйвер не должен вызывать WdfDeviceInitFree после успешного вызова WdfDeviceCreate.

Структура WDFDEVICE_INIT доступна в версии 1.0 и более поздних версиях KMDF.

Требования

Верхний колонтитул

 Wdftypes.h (include Wdftypes.h)