структура 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 доступна в KMDF версии 1.0 и более поздних версиях.

Требования

Заголовок

Wdftypes.h (включая Wdftypes.h)