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