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 會傳回下列其中一個值：

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

備註

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

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

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

HwVidGetPowerState 應設為可分頁。

規格需求

需求 值
目標平台 桌面
標頭 video.h (包含 Video.h)

另請參閱

HwVidGetVideoChildDescriptor

HwVidSetPowerState

VIDEO_POWER_MANAGEMENT