D3COLD_SUPPORT_INTERFACE-Struktur (wdm.h)

Artikel
08/08/2023

Die D3COLD_SUPPORT_INTERFACE-Schnittstellenstruktur enthält Zeiger auf die Routinen in der D3COLD-Supportschnittstelle.

Syntax

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;

Member

Size

Die Größe (in Bytes) dieser Struktur.

Version

Die vom Treiber definierte Schnittstellenversion. Die aktuelle Version dieser Schnittstelle ist D3COLD_SUPPORT_INTERFACE_VERSION.

Context

Ein Zeiger auf schnittstellenspezifische Kontextinformationen.

InterfaceReference

Ein Zeiger auf eine InterfaceReference-Routine , die die Referenzanzahl der Schnittstelle erhöht.

InterfaceDereference

Ein Zeiger auf eine InterfaceDereference-Routine , die die Referenzanzahl der Schnittstelle erhöht.

SetD3ColdSupport

Ein Zeiger auf eine SetD3ColdSupport-Routine , die Übergänge zum D3cold-Gerätestromzustand aktiviert oder deaktiviert.

GetIdleWakeInfo

Ein Zeiger auf eine GetIdleWakeInfo-Routine , die der Gerätetreiber aufruft, um die Gerätestromzustände zu ermitteln, aus denen dieses Gerät Wake-Ereignisse an den Prozessor signalisieren kann.

GetD3ColdCapability

Ein Zeiger auf eine GetD3ColdCapability-Routine , die meldet, ob dieses Gerät in der Lage ist, in den D3cold-Gerätestromzustand zu gelangen.

GetBusDriverD3ColdSupport

Ein Zeiger auf eine GetBusDriverD3ColdSupport-Routine , die meldet, ob der zugrunde liegende Bustreiber und die ACPI-Systemfirmware D3cold für dieses Gerät unterstützen.

GetLastTransitionStatus

Ein Zeiger auf eine GetLastTransitionStatus-Routine , die meldet, ob auf den letzten Übergang dieses Geräts zu D3hot ein Übergang zu D3cold folgte.

Hinweise

Ein Gerätetreiber, der erfolgreich nach der GUID_D3COLD_SUPPORT_INTERFACE-Schnittstelle abfragt, erhält einen Zeiger auf eine D3COLD_SUPPORT_INTERFACE Struktur, in der die Zeiger auf die Routinen in der Schnittstelle alle nicht NULL und gültig sind.

Die D3COLD_SUPPORT_INTERFACE-Struktur ist eine erweiterte Version der INTERFACE-Struktur .