PFNKSDEVICEQUERYPOWER 콜백 함수(ks.h)
AVStream은 IRP_MN_QUERY_POWER 요청을 받으면 미니드라이버의 AVStrMiniDeviceQueryPower 루틴을 호출합니다.
구문
PFNKSDEVICEQUERYPOWER Pfnksdevicequerypower;
NTSTATUS Pfnksdevicequerypower(
[in] PKSDEVICE Device,
[in] PIRP Irp,
[in] DEVICE_POWER_STATE DeviceTo,
[in] DEVICE_POWER_STATE DeviceFrom,
[in] SYSTEM_POWER_STATE SystemTo,
[in] SYSTEM_POWER_STATE SystemFrom,
[in] POWER_ACTION Action
)
{...}
매개 변수
[in] Device
IRP_MN_QUERY_POWER 디스패치한 KSDEVICE 구조체에 대한 포인터입니다.
[in] Irp
디바이스에서 발급한 IRP_MN_QUERY_POWER 대한 포인터입니다.
[in] DeviceTo
Irp 발급자에서 요청한 전원 상태입니다.
[in] DeviceFrom
현재 디바이스 전원 상태입니다.
[in] SystemTo
시스템 전원 상태 전환을 쿼리할 때 지정된 로 전환할 시스템 상태입니다. 디바이스 전원 상태 변경 쿼리로 인해 호출이 발생하는 경우 이 값은 지정되지 않습니다.
[in] SystemFrom
시스템 전원 상태 전환을 쿼리할 때 지정되는 현재 시스템 상태입니다. 디바이스 전원 상태 변경 쿼리로 인해 호출이 발생하는 경우 이 값은 지정되지 않습니다.
[in] Action
요청된 전환에 대한 추가 정보를 지정합니다. 가능한 값은 POWER_ACTION 형식의 열거자입니다.
반환 값
작업을 수행하려는 시도에서 반환된 STATUS_SUCCESS 또는 오류 코드를 반환해야 합니다. STATUS_SUCCESS 반환하면 드라이버는 요청된 전원 상태를 설정하는 기능을 변경하는 작업을 시작하지 않도록 보장합니다. 드라이버는 디바이스를 허용 가능한 전원 상태로 반환하는 IRP_MN_SET_POWER 완료할 때까지 이러한 작업이 필요한 IRP를 큐에 대기해야 합니다.
설명
전원 관리자 또는 디바이스 전원 정책 소유자는 시스템 또는 디바이스 전원 상태를 변경할 수 있는지 여부를 결정하기 위해 IRP_MN_QUERY_POWER 요청을 보냅니다(예: 절전 모드로 이동).
드라이버가 시스템 전원 상태에 대한 IRP_MN_QUERY_POWER 요청에 실패하면 일반적으로 전원 관리자는 IRP_MN_SET_POWER 실행하여 응답합니다. 일반적으로 이 IRP는 현재 시스템 상태를 재확인합니다. 그러나 드라이버가 쿼리된 상태 또는 다른 중간 상태에 대한 IRP_MN_SET_POWER 받을 수 있습니다. 드라이버는 이러한 상황을 처리할 준비가 되어 있어야 합니다.
미니 드라이버는 KSDEVICE_DISPATCH 구조의QueryPower 멤버에서 이 루틴의 주소를 지정합니다.
이 루틴은 선택 사항입니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Microsoft Windows XP 이상 운영 체제 및 DirectX 8.0 이상 DirectX 버전에서 사용할 수 있습니다. |
| 대상 플랫폼 | 데스크톱 |
| 머리글 | ks.h(Ks.h 포함) |