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