PVIDEO_HW_POWER_GET 콜백 함수(video.h)
HwVidGetPowerState 는 디바이스가 요청된 전원 상태를 지원할 수 있는지 여부를 쿼리합니다.
구문
PVIDEO_HW_POWER_GET PvideoHwPowerGet;
VP_STATUS PvideoHwPowerGet(
PVOID HwDeviceExtension,
ULONG HwId,
PVIDEO_POWER_MANAGEMENT VideoPowerControl
)
{...}
매개 변수
HwDeviceExtension
미니포트 드라이버의 어댑터별 스토리지 영역에 대한 포인터입니다. 자세한 내용은 디바이스 확장을 참조하세요.
HwId
미니포트 드라이버가 쿼리해야 하는 디바이스를 고유하게 식별하는 32비트 디바이스 ID 에 대한 포인터입니다. 이 매개 변수는 미니포트 드라이버의 HwVidGetVideoChildDescriptor 함수에서 반환됩니다. 또는 DISPLAY_ADAPTER_HW_ID 값은 전원 정보가 어댑터 자체에 대해 요청되고 있음을 나타냅니다.
VideoPowerControl
지원을 쿼리할 전원 상태를 지정하는 VIDEO_POWER_MANAGEMENT 구조체에 대한 포인터입니다.
반환 값
HwVidGetPowerState 는 다음 값 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
| NO_ERROR | 디바이스는 요청된 전원 상태를 지원합니다. |
| ERROR_DEVICE_REINITIALIZATION_NEEDED | 드라이버가 전원 상태 쿼리에 실패했습니다. |
설명
HwVidGetPowerState 는 비디오 미니포트 드라이버에 필요한 함수입니다.
드라이버는 HwId에 지정된 ID를 검사 쿼리할 디바이스를 결정해야 합니다. 그런 다음, 드라이버는 해당 디바이스가 VideoPowerControl이 가리키는 VIDEO_POWER_MANAGEMENT 구조체의 PowerState 멤버에 지정된 전원 상태를 지원하는지 여부를 결정해야 합니다.
이 함수는 디바이스의 현재 전원 상태를 반환하지 않아야 합니다.
HwVidGetPowerState 를 페이징 가능으로 만들어야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 데스크톱 |
| 머리글 | video.h(Video.h 포함) |