Partager via

D3COLD_REQUEST_AUX_POWER fonction de rappel (wdm.h)

Permet à l’objet d’appareil de fonction (FDO) de transmettre ses besoins en puissance 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 sur 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 requête lorsque la requête échoue avec STATUS_RETRY.

Valeur de retour

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 :

Code d’erreur Description
STATUS_INVALID_PARAMETER Le paramètre d’entrée n’est pas valide.
STATUS_INVALID_DEVICE_REQUEST L’appareil n’est pas dans D0 ou pas le demandeur n’est pas function 0.
STATUS_RETRY La requête a échoué et le système indique qu’une nouvelle tentative peut être effectuée. RetryInSeconds contiendra le nombre de secondes pendant lesquelles le pilote doit attendre avant d’effectuer la requête suivante.
STATUS_UNSUCCESSFUL La requête a échoué et le système indique que la valeur demandée actuelle n’est pas possible.
STATUS_SUCCESS La requête a réussi.

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 dans l’état D0 lorsque cette routine est appelée.

  • Il n’y a aucune garantie que la puissance du rail d’alimentation de base sera supprimée après le succès de cette demande.

Exigences

Exigence Valeur
client minimum pris en charge Windows 10, version 1803
d’en-tête wdm.h (include Wdm.h)
  • Last updated on