PVIDEO_HW_POWER_GET Rückruffunktion (video.h)
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) |