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的詳細資訊，請參閱 建立 Framework Device Object。
例子
下列程式代碼範例會初始化 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
);
要求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 普遍 |
| 最低 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） |