DevicePowerEnumDevices-Funktion (powrprof.h)

  • Artikel

Listet Geräte im System auf, die die angegebenen Kriterien erfüllen.

Syntax

BOOLEAN DevicePowerEnumDevices(
  [in]            ULONG  QueryIndex,
  [in]            ULONG  QueryInterpretationFlags,
  [in]            ULONG  QueryFlags,
  [out, optional] PBYTE  pReturnBuffer,
  [in, out]       PULONG pBufferSize
);

Parameter

[in] QueryIndex

Der Index des angeforderten Geräts. Bei ersten Aufrufen sollte dieser Wert 0 sein.

[in] QueryInterpretationFlags

Die Kriterien, die auf die Suchergebnisse angewendet werden.

Wert Bedeutung
DEVICEPOWER_HARDWAREID
0x80000000
 Gibt eine Hardware-ID-Zeichenfolge anstelle des Anzeigegerätenamens zurück.
DEVICEPOWER_FILTER_DEVICES_PRESENT
0x20000000
 Ignorieren Sie Geräte, die derzeit nicht im System vorhanden sind.
DEVICEPOWER_AND_OPERATION
0x40000000
 Führen Sie einen AND-Vorgang für QueryFlags aus.
DEVICEPOWER_FILTER_WAKEENABLED
0x08000000
 Überprüfen Sie, ob das Gerät derzeit aktiviert ist, um das System aus dem Ruhezustand zu reaktivieren.
DEVICEPOWER_FILTER_ON_NAME
0x02000000
 Suchen Sie ein Gerät, dessen Name mit der in pReturnBuffer übergebenen Zeichenfolge übereinstimmt, und überprüfen Sie dessen Funktionen auf QueryFlags.

[in] QueryFlags

Die Abfragekriterien.

Wert Bedeutung
PDCAP_D0_SUPPORTED
0x00000001
 Das Gerät unterstützt den Systemstromzustand D0.
PDCAP_D1_SUPPORTED
0x00000002
 Das Gerät unterstützt den Systemstromzustand D1.
PDCAP_D2_SUPPORTED
0x00000004
 Das Gerät unterstützt den Systemstromzustand D2.
PDCAP_D3_SUPPORTED
0x00000008
 Das Gerät unterstützt den Systemstromzustand D3.
PDCAP_S0_SUPPORTED
0x00010000
 Das Gerät unterstützt den Systemschlafzustand S0.
PDCAP_S1_SUPPORTED
0x00020000
 Das Gerät unterstützt den Ruhezustand des Systems S1.
PDCAP_S2_SUPPORTED
0x00040000
 Das Gerät unterstützt den Ruhezustand des Systems S2.
PDCAP_S3_SUPPORTED
0x00080000
 Das Gerät unterstützt den Systemschlafzustand S3.
PDCAP_S4_SUPPORTED
0x01000000
 Das Gerät unterstützt den Systemmoduszustand S4.
PDCAP_S5_SUPPORTED
0x02000000
 Das Gerät unterstützt den Systemmoduszustand S5.
PDCAP_WAKE_FROM_D0_SUPPORTED
0x00000010
 Das Gerät unterstützt das Aufwachen aus dem Systemstromzustand D0.
PDCAP_WAKE_FROM_D1_SUPPORTED
0x00000020
 Das Gerät unterstützt das Aufwachen aus dem Systemstromzustand D1.
PDCAP_WAKE_FROM_D2_SUPPORTED
0x00000040
 Das Gerät unterstützt das Aufwachen aus dem Systemstromzustand D2.
PDCAP_WAKE_FROM_D3_SUPPORTED
0x00000080
 Das Gerät unterstützt das Aufwachen aus dem Systemstromzustand D3.
PDCAP_WAKE_FROM_S0_SUPPORTED
0x00100000
 Das Gerät unterstützt das Aufwachen aus dem Systemschlafzustand S0.
PDCAP_WAKE_FROM_S1_SUPPORTED
0x00200000
 Das Gerät unterstützt das Aufwachen aus dem Systemmoduszustand S1.
PDCAP_WAKE_FROM_S2_SUPPORTED
0x00400000
 Das Gerät unterstützt das Aufwachen aus dem Systemschlafzustand S2.
PDCAP_WAKE_FROM_S3_SUPPORTED
0x00800000
 Das Gerät unterstützt das Aufwachen aus dem Systemschlafzustand S3.
PDCAP_WARM_EJECT_SUPPORTED
0x00000100
 Das Gerät unterstützt das Warmauswerfen.

[out, optional] pReturnBuffer

Zeiger auf einen Puffer, der die angeforderten Informationen empfängt.

[in, out] pBufferSize

Die Größe des Rückgabepuffers in Bytes.

Hinweis Wenn pReturnBufferNULL ist, wird pBufferSize mit der Größe gefüllt, die zum Zurückgeben der Daten erforderlich ist.
 

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Hinweise

Die Werte des QueryFlags-Parameters können kombiniert werden, um Geräte abzufragen, die mindestens zwei Kriterien unterstützen. Zum Beispiel; wenn PDCAP_D3_SUPPORTED | PDCAP_D1_SUPPORTED als QueryFlags-Parameter übergeben wird, fragt die Funktion nach Geräten ab, die D3 oder D1 unterstützen.

QueryFlags kann auch mit QueryInterpretationFlags kombiniert werden, die auf DEVICEPOWER_AND_OPERATION festgelegt ist, um eine Abfrage von Geräten zu erstellen, die alle angeforderten Kriterien unterstützen. Zum Beispiel; wenn PDCAP_D3_SUPPORTED | PDCAP_D1_SUPPORTED als QueryFlags-Parameter übergeben und DEVICEPOWER_AND_OPERATION als QueryInterpretationFlags-Parameter übergeben wird, fragt die Funktion Geräte ab, die sowohl D3 als auch D1 unterstützen.

Beispiele

Ein Beispiel, das diese Funktion verwendet, finden Sie unter Verwenden der Geräteenergie-API.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile powrprof.h
Bibliothek PowrProf.lib
DLL PowrProf.dll

Weitere Informationen

Geräteenergieverwaltung