WdfDeviceInitSetPnpPowerEventCallbacks 函式 (wdfdevice.h)
[適用於 KMDF 和 UMDF]
WdfDeviceInitSetPnpPowerEventCallbacks 方法會註冊驅動程式的 隨插即用 和電源管理事件回呼函式。
語法
void WdfDeviceInitSetPnpPowerEventCallbacks(
[in] PWDFDEVICE_INIT DeviceInit,
[in] PWDF_PNPPOWER_EVENT_CALLBACKS PnpPowerEventCallbacks
);
參數
[in] DeviceInit
呼叫端提供的 WDFDEVICE_INIT 結構的指標。
[in] PnpPowerEventCallbacks
呼叫端初始化 WDF_PNPPOWER_EVENT_CALLBACKS 結構的指標。
傳回值
無
備註
如果您的驅動程式呼叫 WdfDeviceInitSetPnpPowerEventCallbacks，它必須先這麼做，才能呼叫 WdfDeviceCreate。
如需呼叫 WdfDeviceCreate 的詳細資訊，請參閱 建立架構裝置物件。
範例
下列程式代碼範例會初始化 WDF_PNPPOWER_EVENT_CALLBACKS 結構，然後呼叫 WdfDeviceInitSetPnpPowerEventCallbacks。
WDF_PNPPOWER_EVENT_CALLBACKS pnpPowerCallbacks;
WDF_PNPPOWER_EVENT_CALLBACKS_INIT(&pnpPowerCallbacks);
pnpPowerCallbacks.EvtDevicePrepareHardware = SerialEvtPrepareHardware;
pnpPowerCallbacks.EvtDeviceReleaseHardware = SerialEvtReleaseHardware;
pnpPowerCallbacks.EvtDeviceD0Entry = SerialEvtDeviceD0Entry;
pnpPowerCallbacks.EvtDeviceD0Exit = SerialEvtDeviceD0Exit;
WdfDeviceInitSetPnpPowerEventCallbacks(
DeviceInit,
&pnpPowerCallbacks
);
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Universal |
| 最低 KMDF 版本 | 1.0 |
| 最低UMDF版本 | 2.0 |
| 標頭 | wdfdevice.h (包含 Wdf.h) |
| 程式庫 | Wdf01000.sys (KMDF) ;WUDFx02000.dll (UMDF) |
| IRQL | <= DISPATCH_LEVEL |
| DDI 合規性規則 | ChildDeviceInitAPI (kmdf) 、 DeviceInitAPI (kmdf) 、 DriverCreate (kmdf) 、 DrvAckIoStop (kmdf) 、 KmdfIrql (kmdf) 、 KmdfIrql2 (kmdf) 、KmdfIrqlExplicit (kmdf) 、 PdoDeviceInitAPI (kmdf) |