Функция WdfDeviceInitSetPowerPolicyEventCallbacks (wdfdevice.h)

Статья
02/29/2024

[Применимо к KMDF и UMDF]

Метод WdfDeviceInitSetPowerPolicyEventCallbacks регистрирует функции обратного вызова события политики питания драйвера.

Синтаксис

void WdfDeviceInitSetPowerPolicyEventCallbacks(
  [in] PWDFDEVICE_INIT                   DeviceInit,
  [in] PWDF_POWER_POLICY_EVENT_CALLBACKS PowerPolicyEventCallbacks
);

Параметры

[in] DeviceInit

Указатель на структуру WDFDEVICE_INIT , предоставленный вызывающим абонентом.

[in] PowerPolicyEventCallbacks

Указатель на инициализированную вызывающей WDF_POWER_POLICY_EVENT_CALLBACKS структуру.

Возвращаемое значение

None

Remarks

Если драйвер вызывает WdfDeviceInitSetPowerPolicyEventCallbacks, он должен сделать это перед вызовом WdfDeviceCreate. Дополнительные сведения см. в разделе Создание объекта устройства платформы.

Дополнительные сведения о WdfDeviceInitSetPowerPolicyEventCallbacks см. в разделе Power Policy Ownership.

Примеры

В следующем примере кода инициализируется структура WDF_POWER_POLICY_EVENT_CALLBACKS , а затем вызывается WdfDeviceInitSetPowerPolicyEventCallbacks.

WDF_POWER_POLICY_EVENT_CALLBACKS powerPolicyCallbacks;

WDF_POWER_POLICY_EVENT_CALLBACKS_INIT(&powerPolicyCallbacks);
powerPolicyCallbacks.EvtDeviceArmWakeFromS0 = PciDrvEvtDeviceWakeArmS0;
powerPolicyCallbacks.EvtDeviceDisarmWakeFromS0 = PciDrvEvtDeviceWakeDisarmS0;
powerPolicyCallbacks.EvtDeviceWakeFromS0Triggered = PciDrvEvtDeviceWakeTriggeredS0;
powerPolicyCallbacks.EvtDeviceArmWakeFromSx = PciDrvEvtDeviceWakeArmSx;
powerPolicyCallbacks.EvtDeviceDisarmWakeFromSx = PciDrvEvtDeviceWakeDisarmSx;
powerPolicyCallbacks.EvtDeviceWakeFromSxTriggered = PciDrvEvtDeviceWakeTriggeredSx;
WdfDeviceInitSetPowerPolicyEventCallbacks(
                                          DeviceInit,
                                          &powerPolicyCallbacks
                                          );

Требования

Требование	Значение
Целевая платформа	Универсальное
Минимальная версия 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), FDOPowerPolicyOwnerAPI(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), NonFDONotPowerPolicyOwnerAPI(kmdf), PdoDeviceInitAPI(kmdf)

См. также раздел

WDF_POWER_POLICY_EVENT_CALLBACKS_INIT

WdfDeviceInitSetPnpPowerEventCallbacks