structure D3COLD_AUX_POWER_AND_TIMING_INTERFACE (wdm.h)

Article
02/27/2024

Version étendue de la structure INTERFACE qui permet aux pilotes de périphériques de négocier une puissance auxiliaire supérieure pour leurs périphériques PCI à l’état D3Cold. Cette interface permet aux pilotes de périphérique d’appeler les fonctions qui manipulent _DSM fonctions 0Ah, 0Bh.

Syntaxe

typedef struct _D3COLD_AUX_POWER_AND_TIMING_INTERFACE {
  USHORT                          Size;
  USHORT                          Version;
  PVOID                           Context;
  PINTERFACE_REFERENCE            InterfaceReference;
  PINTERFACE_DEREFERENCE          InterfaceDereference;
  PD3COLD_REQUEST_CORE_POWER_RAIL RequestCorePowerRail;
  PD3COLD_REQUEST_AUX_POWER       RequestAuxPower;
  PD3COLD_REQUEST_PERST_DELAY     RequestPerstDelay;
} D3COLD_AUX_POWER_AND_TIMING_INTERFACE, *PD3COLD_AUX_POWER_AND_TIMING_INTERFACE;

Membres

Size

Taille, en octets, de cette structure.

Version

Version de l’interface définie par le pilote. La version actuelle de cette interface est D3COLD_AUX_POWER_AND_TIMING_INTERFACE_VERSION.

Context

Pointeur vers des informations de contexte spécifiques à l’interface.

InterfaceReference

Pointeur vers une routine InterfaceReference qui incrémente le nombre de références de l’interface.

InterfaceDereference

Pointeur vers une routine InterfaceDereference qui décrémente le nombre de références de l’interface.

RequestCorePowerRail

Pointeur vers une fonction de rappel D3COLD_REQUEST_CORE_POWER_RAIL qui permet à l’objet de périphérique de fonction (FDO) d’indiquer si la barre d’alimentation principale est nécessaire.

RequestAuxPower

Un pointeur vers une fonction de rappel _D3COLD_REQUEST_AUX_POWER qui permet à l’objet de périphérique de fonction (FDO) de transmettre ses besoins en alimentation auxiliaire.

RequestPerstDelay

Un pointeur vers un D3COLD_REQUEST_PERST_DELAY permet à l’objet de périphérique de fonction (FDO) de transmettre son exigence pour un délai fixe.

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 [D3COLD_AUX_POWER_AND_TIMING_INTERFACE] dans laquelle les pointeurs vers les routines de l’interface sont tous non NULL et valides.

La structure [D3COLD_AUX_POWER_AND_TIMING_INTERFACE] est une version étendue de la structure [INTERFACE].

Windows a désormais ajouté la prise en charge des fonctions _DSM (PCI Device Specific Method) récemment introduites pour runtime Device Power Management. Les nouvelles interfaces répertoriées ci-dessous permettent aux pilotes de périphériques de négocier une puissance auxiliaire plus élevée pour leurs appareils PCI (supérieure à la norme 375mA @ 3.3V), si leurs appareils nécessitent une alimentation supplémentaire en état D3Cold. Tous les pilotes de périphérique doivent être en mesure de gérer les cas où l’alimentation supplémentaire ne peut pas être fournie par le système ou si les interfaces ne sont pas prises en charge.

Tous les ports PCIe qui prennent en charge les fonctions _DSM pour runtime Device Power Management doivent implémenter les données spécifiques aux appareils (_DSD) pour l’identification des ports PCIe prenant en charge D3_COLD_AUX_POWER interface ECN sous l’étendue ACPI du port PCIe.