struttura D3COLD_AUX_POWER_AND_TIMING_INTERFACE (wdm.h)

Articolo
08/08/2023

Una versione estesa della struttura INTERFACE che consente ai driver di dispositivo di negoziare una potenza ausiliaria superiore per i dispositivi PCI mentre è in stato D3Cold. Questa interfaccia consente ai driver di dispositivo di richiamare le funzioni che modificano _DSM funzioni 0Ah, 0Bh.

Sintassi

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;

Members

Size

Dimensione, in byte, della struttura.

Version

Versione dell'interfaccia definita dal driver. La versione corrente di questa interfaccia è D3COLD_AUX_POWER_AND_TIMING_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.

RequestCorePowerRail

Puntatore a una funzione di callback D3COLD_REQUEST_CORE_POWER_RAIL che consente all'oggetto dispositivo funzione (FDO) di indicare se è necessaria la guida di alimentazione principale.

RequestAuxPower

Puntatore a una funzione di callback _D3COLD_REQUEST_AUX_POWER che consente all'oggetto dispositivo funzione (FDO) di trasmettere il relativo requisito di alimentazione ausiliaria.

RequestPerstDelay

Un puntatore a un D3COLD_REQUEST_PERST_DELAY consente all'oggetto dispositivo funzione (FDO) di comunicare il requisito per un tempo di ritardo fisso.

Commenti

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

La struttura [D3COLD_AUX_POWER_AND_TIMING_INTERFACE] è una versione estesa della struttura [INTERFACE].

Windows ha ora aggiunto il supporto per le nuove funzioni PCI Device Specific Method (_DSM) per il risparmio energia del dispositivo di runtime. Le nuove interfacce elencate di seguito consentono ai driver di dispositivo di negoziare una potenza ausiliaria più elevata per i dispositivi PCI (superiore allo standard 375mA @ 3.3V), se i dispositivi richiedono potenza aggiuntiva durante lo stato D3Cold. Tutti i driver di dispositivo devono essere in grado di gestire i casi in cui non è possibile fornire potenza aggiuntiva dal sistema o se le interfacce non sono supportate.

Tutte le porte PCIe che supportano le funzioni di _DSM per il risparmio energia del dispositivo di runtime devono implementare i dati specifici del dispositivo (_DSD) per identificare le porte PCIe che supportano D3_COLD_AUX_POWER interfaccia ECN nell'ambito ACPI della porta PCIe.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10, versione 1803
Intestazione	wdm.h

Vedi anche

_D3COLD_REQUEST_CORE_POWER_RAIL

_D3COLD_REQUEST_AUX_POWER

_D3COLD_REQUEST_PERST_DELAY

Identificazione delle porte PCIe che supportano D3_COLD_AUX_POWER interfaccia ECN

Condividi tramite