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 位 裝置 識別碼的指標,可唯一識別迷你埠驅動程式應該查詢的裝置。 迷你埠驅動程式的 HwVidGetVideoChildDescriptor 函式會傳回此參數。 或者,DISPLAY_ADAPTER_HW_ID值表示正在要求介面卡本身的電源資訊。

VideoPowerControl

指定正在查詢支援之電源狀態 的VIDEO_POWER_MANAGEMENT 結構的指標。

傳回值

HwVidGetPowerState 會傳回下列其中一個值:

傳回碼 描述
NO_ERROR 裝置支援要求的電源狀態。
ERROR_DEVICE_REINITIALIZATION_NEEDED 驅動程式失敗了電源狀態查詢。

備註

HwVidGetPowerState 是視訊迷你埠驅動程式中的必要函式。

驅動程式應該檢查 HwId 中指定的識別碼,以判斷要查詢的裝置。 然後,驅動程式應該判斷該裝置是否支援VideoPowerControl指向之VIDEO_POWER_MANAGEMENT結構之 PowerState成員中指定的電源狀態。

此函式不得傳回裝置的目前電源狀態。

HwVidGetPowerState 應設為可分頁。

規格需求

   
目標平臺 桌面
標頭 video.h (包含 Video.h)

另請參閱

HwVidGetVideoChildDescriptor

HwVidSetPowerState

VIDEO_POWER_MANAGEMENT