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
Device발급된 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 포함) |