PVIDEO_HW_POWER_GET Rückruffunktion (video.h)
HwVidGetPowerState fragt ab, ob das Gerät den angeforderten Leistungszustand unterstützen kann.
Syntax
PVIDEO_HW_POWER_GET PvideoHwPowerGet;
VP_STATUS PvideoHwPowerGet(
PVOID HwDeviceExtension,
ULONG HwId,
PVIDEO_POWER_MANAGEMENT VideoPowerControl
)
{...}
Parameter
HwDeviceExtension
Zeigen Sie 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 ein Wert von DISPLAY_ADAPTER_HW_ID an, dass Strominformationen vom Adapter selbst angefordert werden.
VideoPowerControl
Zeigen Sie 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 | Der Treiber hat die Leistungsstatusabfrage fehlgeschlagen. |
Bemerkungen
HwVidGetPowerState ist eine erforderliche Funktion in einem Video-Miniporttreiber.
Der Treiber sollte die in HwId- angegebene ID überprüfen, um zu bestimmen, welches Gerät abzufragen ist. Der Treiber sollte dann bestimmen, ob das Gerät den im PowerState Member der VIDEO_POWER_MANAGEMENT Struktur angegebenen Energiezustand unterstützt, auf den VideoPowerControl Punkte verweist.
Diese Funktion darf nicht den aktuellen Leistungszustand des Geräts zurückgeben.
HwVidGetPowerState sollte seitenfähig gemacht werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | video.h (video.h einschließen) |