D3COLD_REQUEST_AUX_POWER fonction de rappel (wdm.h)

Article
03/01/2024

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 :

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 le demandeur n’est pas la fonction 0.
STATUS_RETRY	La demande a échoué et le système indique qu’une nouvelle tentative peut être effectuée. RetryInSeconds contient le nombre de secondes que le pilote doit attendre avant d’effectuer la requête suivante.
STATUS_UNSUCCESSFUL	La demande 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 à 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

Condition requise	Valeur
Client minimal pris en charge	Windows 10 version 1803
En-tête	wdm.h (inclure Wdm.h)

Partager via