PVIDEO_HW_POWER_SET コールバック関数 (video.h)

[アーティクル]
02/26/2024

HwVidSetPowerState は、指定したデバイスの電源状態を設定します。

構文

PVIDEO_HW_POWER_SET PvideoHwPowerSet;

VP_STATUS PvideoHwPowerSet(
  PVOID HwDeviceExtension,
  ULONG HwId,
  PVIDEO_POWER_MANAGEMENT VideoPowerControl
)
{...}

パラメーター

HwDeviceExtension

ミニポートドライバーのアダプターごとの記憶域へのポインター。詳細については、「デバイス拡張機能」を参照してください。

HwId

ミニポートドライバーが電源状態を設定する必要があるデバイスを一意に識別する 32 ビットデバイス ID へのポインター。このパラメーターは、ミニポートドライバーの HwVidGetVideoChildDescriptor 関数によって返される値です。 DISPLAY_ADAPTER_HW_ID の値は、ミニポートドライバーがアダプター自体の電源状態を設定する必要があることを示します。

VideoPowerControl

設定する電源状態を指定する VIDEO_POWER_MANAGEMENT 構造体へのポインター。

戻り値

HwVidSetPowerState は常にNO_ERRORを返す必要があります。

注釈

HwVidSetPowerState は、ビデオミニポートドライバーで必要な関数です。

ドライバーは、電源状態を設定するデバイスを決定するために HwId で指定された ID をチェックする必要があります。その後、ドライバーは、そのデバイスの電源状態を、VideoPowerControl が指すVIDEO_POWER_MANAGEMENT構造体の PowerState メンバーで指定されたレベルに設定する必要があります。

HwVidSetPowerState は ページング可能にする必要があります。