struttura D3COLD_SUPPORT_INTERFACE (wdm.h)

Articolo
02/29/2024

La struttura dell'interfaccia D3COLD_SUPPORT_INTERFACE contiene puntatori alle routine nell'interfaccia di supporto D3COLD.

Sintassi

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;

Members

Size

Dimensione, in byte, della struttura.

Version

Versione dell'interfaccia definita dal driver. La versione corrente di questa interfaccia è D3COLD_SUPPORT_INTERFACE_VERSION.

Context

Puntatore a informazioni di contesto specifiche dell'interfaccia.

InterfaceReference

Puntatore a una routine InterfaceReference che incrementa il conteggio dei riferimenti dell'interfaccia.

InterfaceDereference

Puntatore a una routine InterfaceDereference che decrementa il conteggio dei riferimenti dell'interfaccia.

SetD3ColdSupport

Puntatore a una routine SetD3ColdSupport che abilita o disabilita le transizioni allo stato di alimentazione del dispositivo D3cold.

GetIdleWakeInfo

Puntatore a una routine GetIdleWakeInfo che il driver di dispositivo chiama per individuare gli stati di alimentazione del dispositivo da cui questo dispositivo può segnalare gli eventi di riattivazione al processore.

GetD3ColdCapability

Puntatore a una routine GetD3ColdCapability che segnala se il dispositivo è in grado di entrare nello stato di alimentazione del dispositivo D3cold.

GetBusDriverD3ColdSupport

Puntatore a una routine GetBusDriverD3ColdSupport che indica se il driver del bus sottostante e il firmware del sistema ACPI supportano D3cold per questo dispositivo.

GetLastTransitionStatus

Puntatore a una routine GetLastTransitionStatus che segnala se la transizione più recente del dispositivo a D3hot è stata seguita da una transizione a D3cold.

Commenti

Un driver di dispositivo che esegue correttamente una query per l'interfaccia GUID_D3COLD_SUPPORT_INTERFACE riceve un puntatore a una struttura D3COLD_SUPPORT_INTERFACE in cui i puntatori alle routine nell'interfaccia sono tutti non NULL e validi.

La struttura D3COLD_SUPPORT_INTERFACE è una versione estesa della struttura INTERFACE .