estructura D3COLD_SUPPORT_INTERFACE (wdm.h)

Artículo
02/29/2024

La estructura de interfaz D3COLD_SUPPORT_INTERFACE contiene punteros a las rutinas de la interfaz de compatibilidad con D3COLD.

Sintaxis

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;

Miembros

Size

Tamaño, en bytes, de esta estructura.

Version

Versión de la interfaz definida por el controlador. La versión actual de esta interfaz es D3COLD_SUPPORT_INTERFACE_VERSION.

Context

Puntero a información de contexto específica de la interfaz.

InterfaceReference

Puntero a una rutina InterfaceReference que incrementa el recuento de referencias de la interfaz.

InterfaceDereference

Puntero a una rutina InterfaceDereference que disminuye el recuento de referencias de la interfaz.

SetD3ColdSupport

Puntero a una rutina SetD3ColdSupport que habilita o deshabilita las transiciones al estado de alimentación del dispositivo D3cold.

GetIdleWakeInfo

Puntero a una rutina GetIdleWakeInfo a la que el controlador de dispositivo llama para detectar los estados de energía del dispositivo desde los que este dispositivo puede indicar eventos de reactivación al procesador.

GetD3ColdCapability

Puntero a una rutina GetD3ColdCapability que informa si este dispositivo es capaz de entrar en el estado de alimentación del dispositivo D3cold.

GetBusDriverD3ColdSupport

Puntero a una rutina GetBusDriverD3ColdSupport que informa de si el controlador de bus subyacente y el firmware del sistema ACPI admiten D3cold para este dispositivo.

GetLastTransitionStatus

Puntero a una rutina GetLastTransitionStatus que informa de si la transición más reciente de este dispositivo a D3hot fue seguida de una transición a D3cold.

Comentarios

Un controlador de dispositivo que consulta correctamente la interfaz GUID_D3COLD_SUPPORT_INTERFACE recibe un puntero a una estructura D3COLD_SUPPORT_INTERFACE en la que los punteros a las rutinas de la interfaz son todos no NULL y válidos.

La estructura D3COLD_SUPPORT_INTERFACE es una versión extendida de la estructura INTERFACE .