PoSetPowerRequest 함수(wdm.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 반환합니다. 호출이 실패하면 가능한 오류 반환 코드에는 다음이 포함됩니다.
반환 코드 | 설명 |
---|---|
|
Type 매개 변수는 지원되지 않는 값으로 설정됩니다. |
설명
드라이버는 PoSetPowerRequest 루틴을 호출하여 전원 관리자 가 POWER_REQUEST_TYPE 열거형 값으로 지정된 여러 유형의 기본 전원 동작을 재정의하도록 요청할 수 있습니다. 기본 동작을 복원하기 위해 드라이버는 PoClearPowerRequest 루틴을 호출하여 요청을 취소합니다.
전원 관리자는 각 전원 요청 유형에 대한 활성 요청 수를 유지 관리합니다. PoSetPowerRequest 루틴은 지정된 전원 요청 형식의 개수를 1씩 증가합니다. PoClearPowerRequest 루틴은 개수를 1씩 감소합니다. 0이 아닌 개수는 하나 이상의 구성 요소의 요청이 활성 상태임을 나타냅니다. 개수가 0으로 감소하면 컴퓨터가 지정된 전원 요청 형식의 기본 동작으로 되돌아갑니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 7부터 사용할 수 있습니다. |
대상 플랫폼 | 유니버설 |
헤더 | wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함) |
라이브러리 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= DISPATCH_LEVEL |
추가 정보
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기