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 ページング可能にする必要があります。

必要条件

要件	価値
ターゲット プラットフォーム の	デスクトップ
ヘッダー	video.h (Video.h を含む)

関連項目

HwVidGetVideoChildDescriptor の

HwVidSetPowerState の

VIDEO_POWER_MANAGEMENT