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 ビットデバイス ID へのポインター。 このパラメーターは、ミニポート ドライバーの HwVidGetVideoChildDescriptor 関数によって返されます。 または、DISPLAY_ADAPTER_HW_ID の値は、アダプター自体の電源情報が要求されていることを示します。
VideoPowerControl
サポートのクエリ対象の電源状態を指定する VIDEO_POWER_MANAGEMENT 構造体へのポインター。
戻り値
HwVidGetPowerState は、次のいずれかの値を返します。
| リターン コード | 説明 |
|---|---|
| NO_ERROR | デバイスは、要求された電源状態をサポートします。 |
| ERROR_DEVICE_REINITIALIZATION_NEEDED | ドライバーが電源状態クエリに失敗しました。 |
注釈
HwVidGetPowerState は、ビデオ ミニポート ドライバーで必要な関数です。
ドライバーは、HwId で指定された ID をチェックして、クエリを実行するデバイスを決定する必要があります。 ドライバーは、そのデバイスが VideoPowerControl が指すVIDEO_POWER_MANAGEMENT構造体の PowerState メンバーで指定された電源状態をサポートしているかどうかを判断する必要があります。
この関数は、デバイスの現在の電源状態を返してはなりません。
HwVidGetPowerState を ページング可能にする必要があります。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | デスクトップ |
| Header | video.h (Video.h を含む) |