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

Статья
03/22/2025

[Применимо только к 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.

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

Нет

Замечания

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

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

Дополнительные сведения о методе 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 (include Wdf.h)
Библиотека	Wdf01000.sys (см. управление версиями библиотеки Платформы).)
IRQL	PASSIVE_LEVEL
правил соответствия DDI	DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

См. также

WDF_FDO_EVENT_CALLBACKS_INIT

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