structure D3COLD_SUPPORT_INTERFACE (wdm.h)

Article
08/08/2023

La structure d’interface D3COLD_SUPPORT_INTERFACE contient des pointeurs vers les routines dans l’interface de support D3COLD.

Syntaxe

typedef struct _D3COLD_SUPPORT_INTERFACE {
  USHORT                             Size;
  USHORT                             Version;
  PVOID                              Context;
  PINTERFACE_REFERENCE               InterfaceReference;
  PINTERFACE_DEREFERENCE             InterfaceDereference;
  PSET_D3COLD_SUPPORT                SetD3ColdSupport;
  PGET_IDLE_WAKE_INFO                GetIdleWakeInfo;
  PGET_D3COLD_CAPABILITY             GetD3ColdCapability;
  PGET_D3COLD_CAPABILITY             GetBusDriverD3ColdSupport;
  PGET_D3COLD_LAST_TRANSITION_STATUS GetLastTransitionStatus;
} D3COLD_SUPPORT_INTERFACE, *PD3COLD_SUPPORT_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_SUPPORT_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.

SetD3ColdSupport

Pointeur vers une routine SetD3ColdSupport qui active ou désactive les transitions vers l’état d’alimentation de l’appareil D3cold.

GetIdleWakeInfo

Pointeur vers une routine GetIdleWakeInfo que le pilote de périphérique appelle pour découvrir les états d’alimentation de l’appareil à partir desquels cet appareil peut signaler les événements de veille au processeur.

GetD3ColdCapability

Pointeur vers une routine GetD3ColdCapability qui indique si cet appareil est capable d’entrer l’état d’alimentation de l’appareil D3cold.

GetBusDriverD3ColdSupport

Pointeur vers une routine GetBusDriverD3ColdSupport qui indique si le pilote de bus sous-jacent et le microprogramme du système ACPI prennent en charge D3cold pour cet appareil.

GetLastTransitionStatus

Pointeur vers une routine GetLastTransitionStatus qui indique si la dernière transition de cet appareil vers D3hot a été suivie d’une transition vers D3cold.

Remarques

Un pilote de périphérique qui interroge correctement l’interface GUID_D3COLD_SUPPORT_INTERFACE reçoit un pointeur vers une structure D3COLD_SUPPORT_INTERFACE dans laquelle les pointeurs vers les routines de l’interface sont tous non NULL et valides.

La structure D3COLD_SUPPORT_INTERFACE est une version étendue de la structure INTERFACE .