D3COLD_REQUEST_AUX_POWER fonction de rappel (wdm.h)

Permet à l’objet de périphérique de fonction (FDO) de transmettre ses besoins en alimentation auxiliaire.

Syntaxe

D3COLD_REQUEST_AUX_POWER D3coldRequestAuxPower;

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

Paramètres

Context

Handle de l’appareil.

[_In_] AuxPowerInMilliWatts

Puissance en unités de mW dont l’appareil a besoin pour D3cold lorsque le système est en S0. Cette valeur doit être inférieure à 0x80000000.

[_Out_] RetryInSeconds

Pointeur vers une variable ULONG qui reçoit le nombre de secondes pendant lesquelles le pilote peut réessayer sa demande lorsque la demande échoue avec STATUS_RETRY.

Valeur retournée

Retournez STATUS_SUCCESS si l’opération réussit. Sinon, retournez un code d’erreur NTSTATUS Values approprié. Pour plus d’informations, consultez Valeurs NTSTATUS. Les erreurs possibles sont les suivantes :

Remarques

Un pilote de périphérique qui interroge correctement l’interface GUID_D3COLD_AUX_POWER_AND_TIMING_INTERFACE reçoit un pointeur vers une structure de D3COLD_AUX_POWER_AND_TIMING_INTERFACE dans laquelle le pilote définit le membre RequestAuxPower sur un pointeur vers son implémentation de la fonction de rappel D3COLD_REQUEST_AUX_POWER .

• Pour un appareil multi-fonction, seule la fonction 0 est censée appeler cette routine et définir l’alimentation auxiliaire pour l’ensemble de l’appareil.

• La fonction 0 doit être à l’état D0 lorsque cette routine est appelée.

• Il n’existe aucune garantie que l’alimentation de la barre d’alimentation du cœur sera supprimée après la réussite de cette demande.

Configuration requise