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

추가 정보

EvtDeviceWdmPrePoFxUnregisterDevice

WdfDeviceWdmAssignPowerFrameworkSettings