PcRequestNewPowerState 함수(portcls.h)

PcRequestNewPowerState 함수는 디바이스에 대한 새 전원 상태를 요청하는 데 사용됩니다. 이 함수는 일반적으로 어댑터 드라이버에서 필요하지 않지만 일부 종류의 하드웨어 문제를 해결하는 데 유용할 수 있습니다.

구문

PORTCLASSAPI NTSTATUS PcRequestNewPowerState(
  [in] PDEVICE_OBJECT     pDeviceObject,
  [in] DEVICE_POWER_STATE RequestedNewState
);

매개 변수

[in] pDeviceObject

어댑터의 FDO(기능 디바이스 개체)에 대한 포인터입니다. 이 매개 변수는 DEVICE_OBJECT 형식의 시스템 구조를 가리킵니다.

[in] RequestedNewState

요청되는 디바이스 전원 상태를 지정합니다. 이 매개 변수를 PowerDeviceD0, PowerDeviceD1, PowerDeviceD2 또는 PowerDeviceD3의 DEVICE_POWER_STATE 열거형 값 중 하나로 설정합니다.

반환 값

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

설명

어댑터 드라이버는 PcRequestNewPowerState 를 호출하여 하드웨어 디자인 결함을 보완할 수 있습니다. 예를 들어 오디오 어댑터의 함수가 상호 독립적이지 않고 특정 순서로 종료해야 하는 경우 어댑터는 PcRequestNewPowerState 를 호출하여 특정 하위 서비스가 먼저 종료되도록 할 수 있습니다.

RequestedNewState 매개 변수는 다음 표의 DEVICE_POWER_STATE 열거형 값 중 하나로 설정할 수 있습니다.

전원 상태	의미
PowerDeviceD0	전체 전원 상태
PowerDeviceD1	전원 작동 대기 시간이 가장 낮은 절전 상태
PowerDeviceD2	중간 대기 시간 절전 상태
PowerDeviceD3	최대 절전 모드 상태 및 최대 전원 작동 대기 시간이 가장 긴 절전 상태

 

하드웨어는 전원 상태 PowerDeviceD0에서만 액세스할 수 있습니다. 다른 상태에서는 드라이버가 시도한 하드웨어 액세스를 캐시하고 PowerDeviceD0 상태가 복원될 때까지 해당 액세스를 연기해야 합니다.

자세한 내용은 오디오 디바이스용 전원 관리를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	PortCls 시스템 드라이버는 Microsoft Windows 98/Me 및 Windows 2000 이상 운영 체제에서 PcRequestNewPowerState 함수를 구현합니다.
대상 플랫폼	유니버설
헤더	portcls.h(Portcls.h 포함)
라이브러리	Portcls.lib
IRQL	PASSIVE_LEVEL

추가 정보

DEVICE_OBJECT