PVIDEO_HW_POWER_SET Rückruffunktion (video.h)

Artikel
03/01/2024

HwVidSetPowerState legt den Energiezustand des angegebenen Geräts fest.

Syntax

PVIDEO_HW_POWER_SET PvideoHwPowerSet;

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

Parameter

HwDeviceExtension

Zeiger auf den Speicherbereich des Miniporttreibers pro Adapter. Weitere Informationen finden Sie unter Geräteerweiterungen.

HwId

Zeiger auf eine 32-Bit-Geräte-ID , die das Gerät eindeutig identifiziert, für das der Miniporttreiber den Energiezustand festlegen soll. Dieser Parameter ist der Wert, der von der HwVidGetVideoChildDescriptor-Funktion des Miniporttreibers zurückgegeben wird. Der Wert DISPLAY_ADAPTER_HW_ID gibt an, dass der Miniporttreiber den Energiezustand des Adapters selbst festlegen soll.

VideoPowerControl

Zeiger auf eine VIDEO_POWER_MANAGEMENT-Struktur , die den festzulegenden Energiezustand angibt.

Rückgabewert

HwVidSetPowerState sollte immer NO_ERROR zurückgeben.

Hinweise

HwVidSetPowerState ist eine erforderliche Funktion in einem Video-Miniporttreiber.

Der Treiber sollte die in HwId angegebene ID überprüfen, um das Gerät zu ermitteln, auf dem der Energiezustand festgelegt werden soll. Der Treiber sollte dann den Energiezustand dieses Geräts auf die Ebene festlegen, die im PowerState-Member der VIDEO_POWER_MANAGEMENT-Struktur angegeben ist, auf die VideoPowerControl verweist.

HwVidSetPowerState sollte ausgelagert werden.