estrutura D3COLD_AUX_POWER_AND_TIMING_INTERFACE (wdm.h)

Artigo
08/08/2023

Uma versão estendida da estrutura interface que permite que os drivers de dispositivo negociem uma potência auxiliar mais alta para seus dispositivos PCI enquanto estiverem no estado D3Cold. Essa interface permite que os drivers de dispositivo invoquem as funções que manipulam funções de _DSM 0Ah, 0Bh.

Sintaxe

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;

Membros

Size

O tamanho, em bytes, dessa estrutura.

Version

A versão da interface definida pelo driver. A versão atual dessa interface é D3COLD_AUX_POWER_AND_TIMING_INTERFACE_VERSION.

Context

Um ponteiro para informações de contexto específicas da interface.

InterfaceReference

Um ponteiro para uma rotina InterfaceReference que incrementa a contagem de referência da interface.

InterfaceDereference

Um ponteiro para uma rotina InterfaceDereference que diminui a contagem de referência da interface.

RequestCorePowerRail

Um ponteiro para uma função de retorno de chamada D3COLD_REQUEST_CORE_POWER_RAIL que permite que o FDO (objeto do dispositivo de função) indique se o power rail principal é necessário.

RequestAuxPower

Um ponteiro para uma função de retorno de chamada _D3COLD_REQUEST_AUX_POWER que permite que o FDO (objeto do dispositivo de função) transmita seu requisito de energia auxiliar.

RequestPerstDelay

Um ponteiro para um D3COLD_REQUEST_PERST_DELAY permite que o FDO (objeto do dispositivo de função) transmita seu requisito para um tempo de atraso fixo.

Comentários

Um driver de dispositivo que consulta com êxito a interface GUID_D3COLD_AUX_POWER_AND_TIMING_INTERFACE recebe um ponteiro para uma estrutura [D3COLD_AUX_POWER_AND_TIMING_INTERFACE] na qual os ponteiros para as rotinas na interface são todos não NULL e válidos.

A estrutura [D3COLD_AUX_POWER_AND_TIMING_INTERFACE] é uma versão estendida da estrutura [INTERFACE].

O Windows agora adicionou suporte para as funções de método específico do dispositivo PCI (_DSM) recém-introduzidas para o Gerenciamento de Energia de Dispositivo do Runtime. As novas interfaces listadas abaixo permitem que os drivers de dispositivo negociem uma potência auxiliar mais alta para seus dispositivos PCI (superiores aos 375mA padrão @ 3.3V), se seus dispositivos exigirem energia adicional enquanto estiverem no estado D3Cold. Todos os drivers de dispositivo devem ser capazes de lidar com os casos em que a energia adicional não pode ser fornecida pelo sistema ou se as interfaces não têm suporte.

Todas as portas PCIe que dão suporte às funções _DSM para o Gerenciamento de Energia de Dispositivo de Runtime devem implementar os Dados Específicos do Dispositivo (_DSD) para Identificar portas PCIe que dão suporte a D3_COLD_AUX_POWER Interface ECN no escopo ACPI da porta PCIe.