D3COLD_REQUEST_AUX_POWER funzione di callback (wdm.h)

Articolo
02/27/2024

Abilita l'oggetto dispositivo funzione (FDO) per trasmettere il relativo requisito di alimentazione ausiliario.

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 necessarie per il dispositivo 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 che il driver può ripetere 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 Value 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 che il driver deve attendere 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	La richiesta è stata completata.

Commenti

Un driver di dispositivo che esegue correttamente query per l'interfaccia GUID_D3COLD_AUX_POWER_AND_TIMING_INTERFACE riceve un puntatore a una struttura di 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 la funzione 0 chiami questa routine e imposta la potenza ausiliaria per l'intero dispositivo.
La funzione 0 deve essere in stato D0 quando questa routine viene chiamata.
Non vi è alcuna garanzia che la potenza di alimentazione principale verrà rimossa dopo il successo di questa richiesta.

Requisiti

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

Condividi tramite