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가 필요하지 않거나, 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 |