共用方式為

WdfDeviceInitRegisterPowerPolicyStateChangeCallback 函式 (wdfdevice.h)

  • 發行項

[僅適用於 KMDF]

注意

這個方法僅供 Microsoft 內部使用。

WdfDeviceInitRegisterPowerPolicyStateChangeCallback 方法會註冊驅動程式提供的事件回呼函式，此函式會在裝置的電源原則狀態機器變更狀態時呼叫該函式。

語法

NTSTATUS WdfDeviceInitRegisterPowerPolicyStateChangeCallback(
  [in] PWDFDEVICE_INIT                                       DeviceInit,
  [in] WDF_DEVICE_POWER_POLICY_STATE                         PowerPolicyState,
  [in] PFN_WDF_DEVICE_POWER_POLICY_STATE_CHANGE_NOTIFICATION EvtDevicePowerPolicyStateChange,
  [in] ULONG                                                 CallbackTypes
);

參數

[in] DeviceInit

WDFDEVICE_INIT 結構的呼叫 端提供的指標。

[in] PowerPolicyState

識別驅動程式要求通知之電源原則機器狀態 的WDF_DEVICE_POWER_POLICY_STATE 列舉值。

[in] EvtDevicePowerPolicyStateChange

驅動程式 EvtDevicePowerPolicyStateChange 事件回呼函式的呼叫端提供的指標。

[in] CallbackTypes

WDF_STATE_NOTIFICATION_TYPE型別列舉值的 ORed 組合。

傳回值

如果 WdfDeviceInitRegisterPowerPolicyStateChangeCallback 發生任何錯誤，則會傳回STATUS_SUCCESS。 其他傳回值包括：

傳回碼 Description
STATUS_INVALID_PARAMETER
 偵測到無效的參數。
STATUS_INSUFFICIENT_RESOURCES
 記憶體不足，無法完成作業。

備註

如果您的驅動程式呼叫 WdfDeviceInitRegisterPowerPolicyStateChangeCallback，則必須先這麼做，才能呼叫 WdfDeviceCreate。

如需 WdfDeviceInitRegisterPowerPolicyStateChangeCallback 的詳細資訊，請參閱 Framework 中的狀態機器。

範例

下列程式代碼範例會註冊當裝置電源原則狀態機器變更狀態時，架構會呼叫的事件回呼函式。

status = WdfDeviceInitRegisterPowerPolicyStateChangeCallback(
                                 DeviceInit,
                                 WdfDevStatePwrPolCheckPowerPageable,
                                 PciDrvPowerPolicyStateChangeCallback,
                                 StateNotificationAllStates
                                 );

規格需求

需求 值
目標平台 Universal
最小 KMDF 版本 1.0
標頭 wdfdevice.h (包含 Wdf.h)
程式庫 Wdf01000.sys (請參閱 Framework Library Versioning.)
IRQL PASSIVE_LEVEL
DDI 合規性規則 ChildDeviceInitAPI (kmdf) 、 DeviceInitAPI (kmdf ) 、 DriverCreate (kmdf ) 、 InitFreeDeviceCallback (kmdf) 、 InitFreeDeviceCreate (kmdf) 、InitFreeNull (kmdf) 、KmdfIrql (kmdf ) 、KmdfIrql2 (kmdf ) 、KmdfIrqlExplicit (kmdf) 、 PdoDeviceInitAPI (kmdf) 、 PdoInitFreeDeviceCallback (kmdf) 、 PdoInitFreeDeviceCreate (kmdf)