WdfPdoInitSetEventCallbacks 函数 (wdfpdo.h)
[仅适用于 KMDF]
WdfPdoInitSetEventCallbacks 方法注册总线驱动程序的事件回调函数。
语法
void WdfPdoInitSetEventCallbacks(
[in] PWDFDEVICE_INIT DeviceInit,
[in] PWDF_PDO_EVENT_CALLBACKS DispatchTable
);
参数
[in] DeviceInit
指向 WDFDEVICE_INIT 结构的指针。
[in] DispatchTable
指向调用方分配 的WDF_PDO_EVENT_CALLBACKS 结构的指针。
返回值
无
备注
总线驱动程序必须分配 WDF_PDO_EVENT_CALLBACKS 结构,并使用指向驱动程序的事件回调函数的指针填充结构。
驱动程序必须在调用 WdfDeviceCreate 之前调用 WdfPdoInitSetEventCallbacks。 有关调用 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) |
Library | Wdf01000.sys (请参阅框架库 Versioning.) |
IRQL | PASSIVE_LEVEL |
DDI 符合性规则 | ChildDeviceInitAPI (kmdf) 、 DriverCreate (kmdf) 、 KmdfIrql (kmdf) 、 KmdfIrql2 (kmdf) 、 KmdfIrqlExplicit (kmdf) 、 PdoDeviceInitAPI (kmdf) |