D3COLD_AUX_POWER_AND_TIMING_INTERFACE-Struktur (wdm.h)

Artikel
02/27/2024

Eine erweiterte Version der INTERFACE-Struktur, mit der Gerätetreiber im D3Cold-Zustand eine höhere Hilfsleistung für ihre PCI-Geräte aushandeln können. Mit dieser Schnittstelle können Gerätetreiber die Funktionen aufrufen, die _DSM Funktionen 0Ah, 0Bh bearbeiten.

Syntax

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;

Member

Size

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

Version

Die vom Treiber definierte Schnittstellenversion. Die aktuelle Version dieser Schnittstelle ist D3COLD_AUX_POWER_AND_TIMING_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.

RequestCorePowerRail

Ein Zeiger auf eine D3COLD_REQUEST_CORE_POWER_RAIL Rückruffunktion, mit der das Funktionsgeräteobjekt (Function Device Object, FDO) angeben kann, ob die Kern-Power Rail benötigt wird.

RequestAuxPower

Ein Zeiger auf eine _D3COLD_REQUEST_AUX_POWER Rückruffunktion, mit der das Funktionsgeräteobjekt (Function Device Object, FDO) seine Hilfsleistungsanforderung übermitteln kann.

RequestPerstDelay

Ein Zeiger auf eine D3COLD_REQUEST_PERST_DELAY ermöglicht es dem Funktionsgeräteobjekt (Function Device Object, FDO), seine Anforderung für eine feste Verzögerungszeit zu übermitteln.

Hinweise

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

Die [D3COLD_AUX_POWER_AND_TIMING_INTERFACE]-Struktur ist eine erweiterte Version der [INTERFACE]-Struktur.

Windows hat jetzt Unterstützung für die neu eingeführten PCI Device Specific Method (_DSM)-Funktionen für runtime Device Power Management hinzugefügt. Die unten aufgeführten neuen Schnittstellen ermöglichen es Gerätetreibern, eine höhere Hilfsleistung für ihre PCI-Geräte auszuhandeln (höher als der Standard 375mA bei 3,3 V), wenn ihre Geräte im D3Cold-Zustand zusätzliche Energie benötigen. Alle Gerätetreiber müssen in der Lage sein, die Fälle zu verarbeiten, in denen keine zusätzliche Energie vom System bereitgestellt werden kann oder wenn die Schnittstellen nicht unterstützt werden.

Alle PCIe-Ports, die die _DSM Funktionen für runtime Device Power Management unterstützen, müssen die gerätespezifischen Daten (_DSD) zum Identifizieren von PCIe-Ports, die D3_COLD_AUX_POWER ECN-Schnittstelle unterstützen , unter dem ACPI-Bereich des PCIe-Ports implementieren.