PoFxReportDevicePoweredOn 함수(wdm.h)

  • 아티클

PoFxReportDevicePoweredOn 루틴은 디바이스가 요청된 D0(완전 켜기) 전원 상태로의 전환을 완료했음을 PoFx(전원 관리 프레임워크)에 알릴 수 있습니다.

구문

void PoFxReportDevicePoweredOn(
  [in] POHANDLE Handle
);

매개 변수

[in] Handle

PoFx(전원 관리 프레임워크)를 사용하여 디바이스 등록을 나타내는 핸들입니다. 디바이스 드라이버는 이전에 PoFxRegisterDevice 루틴에서 이 핸들을 받았습니다.

반환 값

없음

설명

등록된 디바이스의 드라이버는 다음이 발생한 후 PoFxReportDevicePoweredOn 을 호출해야 합니다.

  • PoFx는 드라이버의 DevicePowerRequiredCallback 콜백 루틴을 호출하여 디바이스가 D0 전원 상태를 입력해야 한다고 드라이버에 알립니다.
  • PoFx는 드라이버의 DirectedPowerUpCallback 콜백 루틴을 호출하여 디바이스가 D0 전원 상태를 입력해야 한다고 드라이버에 알립니다.
  • PoFx는 드라이버에 S0 IRP( IRP_MN_SET_POWER 요청)를 보내 보류 중인 시스템 전환을 S0 전원 상태로 전환하도록 드라이버에 알립니다.
두 항목 중 하나에 대한 응답으로 드라이버는 D0 IRP( IRP_MN_SET_POWER 요청)를 디바이스 스택 아래로 보내 디바이스가 아직 D0 상태에 있지 않은 경우 D0 전원 상태로 전환을 시작합니다. 드라이버가 D0 상태로의 전환을 완료하고 모든 하위 드라이버가 완료되면 드라이버는 PoFxReportDevicePoweredOn 을 호출하여 PoFx에 알립니다.

드라이버는 D0 IRP가 필요하지 않거나, D0 IRP 요청이 실패하거나, 디스패치된 D0 IRP가 성공하거나 실패하거나, S0 IRP가 성공하거나 실패하는지에 관계없이 PoFxReportDevicePoweredOn 을 호출해야 합니다.

전원 필요/직접 전원 켜기 콜백의 경우 콜백 호출 중 또는 이후에 PoFxReportDevicePoweredOn 호출이 발생할 수 있습니다.

S0 IRP 요청의 경우 드라이버는 가능한 한 빨리 이 요청을 완료하고, 디바이스를 D0 전원 상태로 전환하고, PoFxReportDevicePoweredOn을 호출해야 합니다. 자세한 내용은 디바이스 전원 정책 소유자에서 시스템 Set-Power IRP 처리를 참조하세요.

PoFxReportDevicePoweredOn에 진입하면 디바이스가 초기화되지 않은 D0 전원 상태일 수 있으며 디바이스의 모든 구성 요소가 켜져 있을 수 있습니다. PoFxReportDevicePoweredOn 호출에 대한 응답으로 PoFx는 초기화된 D0 상태에서 디바이스를 구성합니다. 이 구성 중에 PoFx는 가능한 한 많은 구성 요소를 저전력 Fx 전원 상태로 전환합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 8 사용하여 사용할 수 있습니다.
대상 플랫폼 유니버설
헤더 wdm.h
라이브러리 Ntoskrnl.lib
DLL Ntoskrnl.exe
IRQL <= DISPATCH_LEVEL

추가 정보

DevicePowerRequiredCallback

IRP_MN_SET_POWER

PoFxRegisterDevice