D3COLD_REQUEST_AUX_POWER Rückruffunktion (wdm.h)

Artikel
02/27/2024

Ermöglicht dem Funktionsgeräteobjekt (Function Device Object, FDO), seine Zusätzliche Energieanforderung zu übermitteln.

Syntax

D3COLD_REQUEST_AUX_POWER D3coldRequestAuxPower;

NTSTATUS D3coldRequestAuxPower(
  [_In_reads_opt_(_Inexpressible_("varies"))] PVOID Context,
  [_In_]                                      ULONG AuxPowerInMilliWatts,
  [_Out_]                                     PULONG RetryInSeconds
)
{...}

Parameter

Context

Der Handle für das Gerät.

[_In_] AuxPowerInMilliWatts

Die Wattleistung in Einheiten von mW, die das Gerät für D3cold benötigt, wenn sich das System in S0 befindet. Dieser Wert muss kleiner als 0x80000000 sein.

[_Out_] RetryInSeconds

Ein Zeiger auf eine ULONG-Variable, die die Anzahl von Sekunden empfängt, die der Treiber seine Anforderung wiederholen kann, wenn die Anforderung mit STATUS_RETRY fehlschlägt.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls geben Sie einen entsprechenden NTSTATUS-Werte-Fehlercode zurück. Weitere Informationen finden Sie unter NTSTATUS-Werte. Mögliche Fehler sind wie folgt:

Fehlercode	BESCHREIBUNG
STATUS_INVALID_PARAMETER	Der Eingabeparameter ist ungültig.
STATUS_INVALID_DEVICE_REQUEST	Das Gerät befindet sich nicht in D0 oder nicht der Anforderer ist nicht Funktion 0.
STATUS_RETRY	Die Anforderung ist fehlgeschlagen, und das System gibt an, dass ein Wiederholungsversuch durchgeführt werden kann. RetryInSeconds enthält die Anzahl der Sekunden, die der Treiber warten sollte, bevor er die nächste Anforderung stellt.
STATUS_UNSUCCESSFUL	Die Anforderung ist fehlgeschlagen, und das System gibt an, dass der aktuell angeforderte Wert nicht möglich ist.
STATUS_SUCCESS	Die Anforderung war erfolgreich.

Hinweise

Ein Gerätetreiber, der erfolgreich nach der GUID_D3COLD_AUX_POWER_AND_TIMING_INTERFACE-Schnittstelle abfragt, erhält einen Zeiger auf eine D3COLD_AUX_POWER_AND_TIMING_INTERFACE-Struktur , in der der Treiber den RequestAuxPower-Member auf einen Zeiger auf die Implementierung der D3COLD_REQUEST_AUX_POWER Rückruffunktion festlegt.

Bei einem Mehrfunktionsgerät wird erwartet, dass nur Die Funktion 0 diese Routine aufruft und die Hilfsleistung für das gesamte Gerät festgelegt.
Funktion 0 muss sich im D0-Zustand befinden, wenn diese Routine aufgerufen wird.
Es gibt keine Garantie dafür, dass der Kernstrom der Power Rail nach dem Erfolg dieser Anforderung entfernt wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1803
Kopfzeile	wdm.h (einschließen von Wdm.h)

Freigeben über