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.