Функция WdfFdoInitSetEventCallbacks (wdffdo.h)

  • Статья

[Применяется только к KMDF]

Метод WdfFdoInitSetEventCallbacks регистрирует функции обратного вызова событий драйвера на основе платформы для указанного устройства.

Синтаксис

void WdfFdoInitSetEventCallbacks(
  [in] PWDFDEVICE_INIT          DeviceInit,
  [in] PWDF_FDO_EVENT_CALLBACKS FdoEventCallbacks
);

Параметры

[in] DeviceInit

Указатель на структуру WDFDEVICE_INIT , полученную драйвером из функции обратного вызова EvtDriverDeviceAdd .

[in] FdoEventCallbacks

Указатель на структуру, выделенную драйвером WDF_FDO_EVENT_CALLBACKS .

Возвращаемое значение

None

Remarks

Перед вызовом WdfFdoInitSetEventCallbacks драйвер должен выделить структуру WDF_FDO_EVENT_CALLBACKS и заполнить структуру указателями на функции обратного вызова событий драйвера.

Драйвер должен вызвать WdfFdoInitSetEventCallbacks перед вызовом WdfDeviceCreate. Дополнительные сведения о вызове WdfDeviceCreate см. в разделе Создание объекта устройства платформы.

Дополнительные сведения о методе WdfFdoInitSetEventCallbacks см. в статье Создание объектов устройств в драйвере функции.

Примеры

В следующем примере кода инициализируется структура WDF_FDO_EVENT_CALLBACKS, а затем вызывается WdfFdoInitSetEventCallbacks.

WDF_FDO_EVENT_CALLBACKS fdoCallbacks;

WDF_FDO_EVENT_CALLBACKS_INIT(&fdoCallbacks);
fdoCallbacks.EvtDeviceFilterAddResourceRequirements = MyEvtDeviceFilterAddResourceRequirements;
fdoCallbacks.EvtDeviceFilterRemoveResourceRequirements = MyEvtDeviceFilterRemoveResourceRequirements;
fdoCallbacks.EvtDeviceRemoveAddedResources = MyEvtDeviceRemoveAddedResources;

WdfFdoInitSetEventCallbacks(
                            DeviceInit,
                            &fdoCallbacks
                            );

Требования

Требование Значение
Целевая платформа Универсальное
Минимальная версия KMDF 1,0
Верхняя часть wdffdo.h (включая Wdf.h)
Библиотека Wdf01000.sys (см. раздел Управление версиями библиотеки платформы).
IRQL PASSIVE_LEVEL
Правила соответствия DDI DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

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

WDF_FDO_EVENT_CALLBACKS_INIT