функция обратного вызова EVT_WDFDEVICE_WDM_POST_PO_FX_REGISTER_DEVICE (wdfdevice.h)

  • Статья

[Относится только к KMDF]

Функция обратного вызова EvtDeviceWdmPostPoFxRegisterDevice выполняет операции, относящиеся к устройству, после регистрации платформы в power Framework.

Синтаксис

EVT_WDFDEVICE_WDM_POST_PO_FX_REGISTER_DEVICE EvtWdfdeviceWdmPostPoFxRegisterDevice;

NTSTATUS EvtWdfdeviceWdmPostPoFxRegisterDevice(
  [in] WDFDEVICE Device,
  [in] POHANDLE PoHandle
)
{...}

Параметры

[in] Device

Дескриптор объекта устройства платформы.

[in] PoHandle

Дескриптор, представляющий регистрацию устройства в power framework.

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

Значение NTSTATUS, указывающее на успешное выполнение или сбой операций, выполненных в этом обратном вызове. Если возвращается сбой, платформа, в свою очередь, завершится сбоем IRP_MN_START_DEVICE.

Комментарии

Если вы пишете драйвер KMDF для однокомпонентного устройства, которое определяет несколько состояний функционального питания, можно зарегистрировать функцию обратного вызова EvtDeviceWdmPostPoFxRegisterDevice , чтобы получать уведомления после регистрации платформы в платформе управления питанием (PoFx).

Чтобы зарегистрировать EvtDeviceWdmPostPoFxRegisterDevice, драйвер должен вызвать WdfDeviceWdmAssignPowerFrameworkSettings.

PoHANDLE, полученный в EvtDeviceWdmPostPoFxRegisterDevice, остается действительным до тех пор, пока драйвер не вернется из EvtDeviceWdmPrePoFxUnregisterDevice.

Драйвер может использовать POHANDLE для вызова PoFxSetComponentLatency, PoFxSetComponentResidency и PoFxSetComponentWake для указания задержки, расположения и пробуждения для платформы power framework.

Драйвер также может использовать POHANDLE для вызова PoFxPowerControl для отправки запроса на управление питанием в PoFx.

Драйвер KMDF для многокомпонентного устройства не предоставляет EvtDeviceWdmPostPoFxRegisterDevice. Вместо этого такой драйвер получает POHANDLE при вызове PoFxRegisterDevice. Дополнительные сведения см. в разделе Поддержка нескольких функциональных состояний питания для устройств Multiple-Component.

Требования

Требование Значение
Целевая платформа Универсальное
Минимальная версия KMDF 1.11
Верхняя часть wdfdevice.h (включая Wdf.h)
IRQL PASSIVE_LEVEL

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

EvtDeviceWdmPrePoFxUnregisterDevice

WdfDeviceWdmAssignPowerFrameworkSettings