EVT_WDFDEVICE_WDM_POST_PO_FX_REGISTER_DEVICE 콜백 함수(wdfdevice.h)
[KMDF에만 적용]
EvtDeviceWdmPostPoFxRegisterDevice 콜백 함수는 프레임워크가 전원 프레임워크에 등록된 후 디바이스별 작업을 수행합니다.
구문
EVT_WDFDEVICE_WDM_POST_PO_FX_REGISTER_DEVICE EvtWdfdeviceWdmPostPoFxRegisterDevice;
NTSTATUS EvtWdfdeviceWdmPostPoFxRegisterDevice(
[in] WDFDEVICE Device,
[in] POHANDLE PoHandle
)
{...}
매개 변수
[in] Device
프레임워크 디바이스 개체에 대한 핸들입니다.
[in] PoHandle
전원 프레임워크를 사용하여 디바이스의 등록을 나타내는 핸들입니다.
반환 값
이 콜백에서 수행된 작업의 성공 또는 실패를 나타내는 NTSTATUS 값입니다. 오류가 반환되면 프레임워크는 IRP_MN_START_DEVICE 실패합니다.
설명
여러 기능 전원 상태를 정의하는 단일 구성 요소 디바이스에 대한 KMDF 드라이버를 작성하는 경우 프레임워크가 PoFx(전원 관리 프레임워크)에 등록한 후 알림을 받을 EvtDeviceWdmPostPoFxRegisterDevice 콜백 함수를 등록할 수 있습니다.
EvtDeviceWdmPostPoFxRegisterDevice를 등록하려면 드라이버가 WdfDeviceWdmAssignPowerFrameworkSettings를 호출해야 합니다.
EvtDeviceWdmPostPoFxRegisterDevice에서 받은 POHANDLE은 드라이버가 EvtDeviceWdmPrePoFxUnregisterDevice에서 반환될 때까지 유효한 상태로 유지됩니다.
드라이버는 POHANDLE을 사용하여 PoFxSetComponentLatency, PoFxSetComponentResidency 및 PoFxSetComponentWake 를 호출하여 Power Framework에 대한 대기 시간, 상주 및 절전 모드 해제 힌트를 지정할 수 있습니다.
드라이버는 POHANDLE을 사용하여 PoFxPowerControl을 호출하여 PoFx 에 전원 제어 요청을 보낼 수도 있습니다.
여러 구성 요소 디바이스에 대한 KMDF 드라이버는 EvtDeviceWdmPostPoFxRegisterDevice를 제공하지 않습니다. 대신 이러한 드라이버는 PoFxRegisterDevice를 호출할 때 POHANDLE을 받습니다. 자세한 내용은 Multiple-Component 디바이스에 대한 여러 기능 전원 상태 지원을 참조하세요.
요구 사항
요구 사항 | 값 |
---|---|
대상 플랫폼 | 유니버설 |
최소 KMDF 버전 | 1.11 |
머리글 | wdfdevice.h(Wdf.h 포함) |
IRQL | PASSIVE_LEVEL |