PVIDEO_HW_POWER_SET Rückruffunktion (video.h)
HwVidSetPowerState legt den Leistungszustand des angegebenen Geräts fest.
Syntax
PVIDEO_HW_POWER_SET PvideoHwPowerSet;
VP_STATUS PvideoHwPowerSet(
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, für das der Miniporttreiber den Energiezustand festlegen soll. Dieser Parameter ist der Wert, der von der HwVidGetVideoChildDescriptor- funktion des Miniporttreibers zurückgegeben wird. Ein Wert von DISPLAY_ADAPTER_HW_ID gibt an, dass der Miniporttreiber den Leistungszustand 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.
Bemerkungen
HwVidSetPowerState ist eine erforderliche Funktion in einem Video-Miniporttreiber.
Der Treiber sollte die in HwId- angegebene ID überprüfen, um das Gerät zu bestimmen, 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 Punkte verweist.
HwVidSetPowerState sollte seitenfähig gemacht werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | video.h (video.h einschließen) |