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 포함)

추가 정보

IRP_MN_QUERY_POWER

KSDEVICE_DISPATCH