функция обратного вызова 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 устройств.

Требования

См. также

EvtDeviceWdmPrePoFxUnregisterDevice

WdfDeviceWdmAssignPowerFrameworkSettings