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