共用方式為


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 中指定的標識碼,以判斷要查詢的裝置。 然後,驅動程式應該判斷該裝置是否支援 PowerState 中所指定的電源狀態VIDEO_POWER_MANAGEMENT 結構的成員,VideoPowerControl 點。

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

HwVidGetPowerState 應設為可分頁。

要求

要求 價值
目標平臺 桌面
標頭 video.h (include Video.h)

另請參閱

HwVidGetVideoChildDescriptor

HwVidSetPowerState

VIDEO_POWER_MANAGEMENT