D3COLD_REQUEST_AUX_POWER funzione di callback (wdm.h)

Articolo
02/07/2025

Consente all'oggetto dispositivo funzione (FDO) di trasmettere i requisiti di alimentazione ausiliari.

Sintassi

D3COLD_REQUEST_AUX_POWER D3coldRequestAuxPower;

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

Parametri

Context

Handle per il dispositivo.

[_In_] AuxPowerInMilliWatts

Wattage in unità di mW che il dispositivo ha bisogno di D3cold quando il sistema è in S0. Questo valore deve essere minore di 0x80000000.

[_Out_] RetryInSeconds

Puntatore a una variabile ULONG che riceve il numero di secondi in cui il driver può ritentare la richiesta quando la richiesta ha esito negativo con STATUS_RETRY.

Valore restituito

Restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, restituire un codice di errore NTSTATUS Values appropriato. Per altre informazioni, vedere valori NTSTATUS. I possibili errori sono i seguenti:

Codice di errore	Descrizione
STATUS_INVALID_PARAMETER	Il parametro di input non è valido.
STATUS_INVALID_DEVICE_REQUEST	Il dispositivo non è in D0 o non il richiedente non è funzione 0.
STATUS_RETRY	La richiesta non è riuscita e il sistema indica che è possibile eseguire un nuovo tentativo. RetryInSeconds conterrà il numero di secondi di attesa del driver prima di effettuare la richiesta successiva.
STATUS_UNSUCCESSFUL	La richiesta non è riuscita e il sistema indica che il valore richiesto corrente non è possibile.
STATUS_SUCCESS	Richiesta riuscita.

Osservazioni

Un driver di dispositivo che esegue correttamente una query per l'interfaccia GUID_D3COLD_AUX_POWER_AND_TIMING_INTERFACE riceve un puntatore a una struttura D3COLD_AUX_POWER_AND_TIMING_INTERFACE in cui il driver imposta il membro RequestAuxPower su un puntatore alla relativa implementazione della funzione di callback D3COLD_REQUEST_AUX_POWER.

Per un dispositivo a più funzioni, è previsto che solo la funzione 0 chiami questa routine e imposti l'alimentazione ausiliaria per l'intero dispositivo.
La funzione 0 deve essere nello stato D0 quando viene chiamata questa routine.
Non c'è garanzia che la potenza del binario di alimentazione principale verrà rimossa dopo il successo di questa richiesta.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 10, versione 1803
intestazione	wdm.h (include Wdm.h)

Condividi tramite