PoSetPowerRequest 함수(ntifs.h)
PoSetPowerRequest 루틴은 지정된 전원 요청 형식의 수를 증가합니다.
구문
NTSTATUS PoSetPowerRequest(
[in, out] PVOID PowerRequest,
[in] POWER_REQUEST_TYPE Type
);
매개 변수
[in, out] PowerRequest
PoCreatePowerRequest 루틴에서 만든 전원 요청 개체에 대한 포인터입니다.
[in] Type
전원 요청의 유형입니다. 이 매개 변수를 다음 POWER_REQUEST_TYPE 열거형 값으로 설정합니다.
- PowerRequestSystemRequired
반환 값
PoSetPowerRequest 는 호출이 성공하면 STATUS_SUCCESS 반환합니다. 호출이 실패하면 가능한 오류 반환 코드에는 다음이 포함됩니다.
| 반환 코드 | 설명 |
|---|---|
| STATUS_NOT_SUPPORTED | Type 매개 변수는 지원되지 않는 값으로 설정됩니다. |
설명
드라이버는 PoSetPowerRequest 루틴을 호출하여 전원 관리자 가 POWER_REQUEST_TYPE 열거형 값으로 지정된 여러 유형의 기본 전원 동작을 재정의하도록 요청할 수 있습니다. 기본 동작을 복원하기 위해 드라이버는 PoClearPowerRequest 루틴을 호출하여 요청을 취소합니다.
전원 관리자는 각 전원 요청 유형에 대한 활성 요청 수를 유지 관리합니다. PoSetPowerRequest 루틴은 지정된 전원 요청 형식의 개수를 1씩 증가합니다. PoClearPowerRequest 루틴은 개수를 1씩 감소합니다. 0이 아닌 개수는 하나 이상의 구성 요소의 요청이 활성 상태임을 나타냅니다. 개수가 0으로 감소하면 컴퓨터가 지정된 전원 요청 형식의 기본 동작으로 되돌아갑니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 7 |
| 대상 플랫폼 | 유니버설 |
| 헤더 | ntifs.h(Wdm.h, Ntddk.h, Ntifs.h 포함) |
| 라이브러리 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |