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 を含む)

こちらもご覧ください

HwVidGetVideoChildDescriptor

HwVidSetPowerState

VIDEO_POWER_MANAGEMENT