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

Требования