PVIDEO_HW_POWER_GET Rückruffunktion (video.h)

  • Artikel

HwVidGetPowerState fragt ab, ob das Gerät den angeforderten Energiezustand unterstützen kann.

Syntax

PVIDEO_HW_POWER_GET PvideoHwPowerGet;

VP_STATUS PvideoHwPowerGet(
  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, das der Miniporttreiber abfragen soll. Dieser Parameter wird von der HwVidGetVideoChildDescriptor-Funktion des Miniporttreibers zurückgegeben. Alternativ gibt der Wert DISPLAY_ADAPTER_HW_ID an, dass Energieinformationen vom Adapter selbst angefordert werden.

VideoPowerControl

Zeiger auf eine VIDEO_POWER_MANAGEMENT Struktur, die den Energiezustand angibt, für den die Unterstützung abgefragt wird.

Rückgabewert

HwVidGetPowerState gibt einen der folgenden Werte zurück:

Rückgabecode Beschreibung
NO_ERROR Das Gerät unterstützt den angeforderten Energiezustand.
ERROR_DEVICE_REINITIALIZATION_NEEDED Fehler beim Treiber bei der Energiezustandsabfrage.

Hinweise

HwVidGetPowerState ist eine erforderliche Funktion in einem Video-Miniporttreiber.

Der Treiber sollte die in HwId angegebene ID überprüfen, um das abzufragende Gerät zu bestimmen. Der Treiber sollte dann bestimmen, ob dieses Gerät den Energiezustand unterstützt, der im PowerState-Member der VIDEO_POWER_MANAGEMENT Struktur angegeben ist, auf die VideoPowerControl verweist.

Diese Funktion darf nicht den aktuellen Energiezustand des Geräts zurückgeben.

HwVidGetPowerState sollte als ausgelagert werden.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile video.h (Video.h einschließen)

Weitere Informationen

HwVidGetVideoChildDescriptor

HwVidSetPowerState

VIDEO_POWER_MANAGEMENT