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 結構，並以驅動程式事件回呼函式的指標填入結構。
驅動程序必須先呼叫 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
);
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Universal |
| 最低 KMDF 版本 | 1.0 |
| 標頭 | wdfpdo.h (包含 Wdf.h) |
| 程式庫 | Wdf01000.sys (請參閱 Framework Library Versioning.) |
| IRQL | PASSIVE_LEVEL |
| DDI 合規性規則 | ChildDeviceInitAPI (kmdf) ， DriverCreate (kmdf) ， KmdfIrql (kmdf ) ， KmdfIrql2 (kmdf) ， KmdfIrqlExplicit (kmdf) ， PdoDeviceInitAPI (kmdf) |