estrutura D3COLD_SUPPORT_INTERFACE (wdm.h)

Artigo
08/08/2023

A estrutura da interface D3COLD_SUPPORT_INTERFACE contém ponteiros para as rotinas na Interface de Suporte D3COLD.

Sintaxe

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;

Membros

Size

O tamanho, em bytes, dessa estrutura.

Version

A versão da interface definida pelo driver. A versão atual dessa interface é D3COLD_SUPPORT_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.

SetD3ColdSupport

Um ponteiro para uma rotina SetD3ColdSupport que habilita ou desabilita transições para o estado de energia do dispositivo D3cold.

GetIdleWakeInfo

Um ponteiro para uma rotina GetIdleWakeInfo que o driver do dispositivo chama para descobrir os estados de energia do dispositivo dos quais esse dispositivo pode sinalizar eventos de ativação para o processador.

GetD3ColdCapability

Um ponteiro para uma rotina GetD3ColdCapability que relata se esse dispositivo é capaz de entrar no estado de energia do dispositivo D3cold.

GetBusDriverD3ColdSupport

Um ponteiro para uma rotina GetBusDriverD3ColdSupport que relata se o driver de barramento subjacente e o firmware do sistema ACPI dão suporte a D3cold para este dispositivo.

GetLastTransitionStatus

Um ponteiro para uma rotina GetLastTransitionStatus que relata se a transição mais recente desse dispositivo para D3hot foi seguida por uma transição para D3cold.

Comentários

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

A estrutura D3COLD_SUPPORT_INTERFACE é uma versão estendida da estrutura INTERFACE .