Функция WdfPdoInitSetEventCallbacks (wdfpdo.h)

Статья
02/27/2024

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

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

Синтаксис

void WdfPdoInitSetEventCallbacks(
  [in] PWDFDEVICE_INIT          DeviceInit,
  [in] PWDF_PDO_EVENT_CALLBACKS DispatchTable
);

Параметры

[in] DeviceInit

Указатель на структуру WDFDEVICE_INIT .

[in] DispatchTable

Указатель на структуру WDF_PDO_EVENT_CALLBACKS , выделенную вызывающим объектом.

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

None

Remarks

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

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

Примеры

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

PWDFDEVICE_INIT  pDeviceInit = NULL;
WDF_PDO_EVENT_CALLBACKS  pdoCallbacks;

pDeviceInit = WdfPdoInitAllocate(Device);
WDF_PDO_EVENT_CALLBACKS_INIT(&pdoCallbacks);
pdoCallbacks.EvtDeviceResourceRequirementsQuery = Bus_Pdo_EvtDeviceResourceRequirementsQuery;
WdfPdoInitSetEventCallbacks(
                            pDeviceInit,
                            &pdoCallbacks
                            );

Требования

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

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

WDF_PDO_EVENT_CALLBACKS_INIT

WdfPdoInitAllocate