IAdapterPowerManagement::QueryPowerChangeState 메서드(portcls.h)

아티클
02/26/2024

메서드는 QueryPowerChangeStateIRP_MN_QUERY_POWER 전원 IRP 수신에 대한 응답으로 PortCls에서 호출됩니다.

구문

NTSTATUS QueryPowerChangeState(
  [in] POWER_STATE NewStateQuery
);

매개 변수

[in] NewStateQuery

디바이스에 대해 요청되는 새 전원 상태를 지정합니다. 이 매개 변수는 POWER_STATE 형식의 공용 구조체입니다. 새 전원 상태(NewStateQuery.DeviceState)는 IAdapterPowerManagement::P owerChangeState에 나열된 DEVICE_POWER_STATE 열거형 값 중 하나일 수 있습니다.

반환 값

QueryPowerChangeState 는 호출에 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 메서드는 적절한 오류 코드를 반환합니다.

설명

PortCls는 QueryPowerChangeState 시스템을 대신하여 메서드를 호출하여 어댑터 드라이버에 잠재적인 디바이스 전원 상태 변경 허용 여부를 쿼리합니다. 드라이버는 STATUS_SUCCESS 이외의 값을 반환하여 전원 상태 변경을 거부할 수 있습니다. 에 대한 QueryPowerStateChange 호출은 모든 PowerChangeState 호출 이전에 발생하도록 보장되지 않습니다.

이 메서드의 코드는 페이징된 메모리에 있어야 합니다.