D3COLD_REQUEST_AUX_POWER funzione di callback (wdm.h)

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:

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