PoClearPowerRequest 함수(wdm.h)

PoClearPowerRequest 루틴은 지정된 전원 요청 형식의 수를 감소합니다.

구문

NTSTATUS PoClearPowerRequest(
  [in, out] PVOID              PowerRequest,
  [in]      POWER_REQUEST_TYPE Type
);

매개 변수

[in, out] PowerRequest

PoCreatePowerRequest 루틴에서 만든 전원 요청 개체에 대한 포인터입니다.

[in] Type

전원 요청의 형식입니다. 이 매개 변수를 다음 POWER_REQUEST_TYPE 열거형 값으로 설정합니다.

• PowerRequestSystemRequired

반환 값

PoClearPowerRequest 는 호출이 성공하면 STATUS_SUCCESS 반환합니다. 호출이 실패하면 가능한 오류 반환 코드에는 다음이 포함됩니다.

반환 코드	설명
STATUS_NOT_SUPPORTED	매개 변수 형식 이 지원되지 않는 값으로 설정됩니다.

설명

드라이버는 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

추가 정보

POWER_REQUEST_TYPE

PoCreatePowerRequest

PoSetPowerRequest