Edit

D3COLD_SUPPORT_INTERFACE structure (wdm.h)

  • Article

The D3COLD_SUPPORT_INTERFACE interface structure contains pointers to the routines in the D3COLD Support Interface.

Syntax

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;

Members

Size

The size, in bytes, of this structure.

Version

The driver-defined interface version. The current version of this interface is D3COLD_SUPPORT_INTERFACE_VERSION.

Context

A pointer to interface-specific context information.

InterfaceReference

A pointer to an InterfaceReference routine that increments the interface's reference count.

InterfaceDereference

A pointer to an InterfaceDereference routine that decrements the interface's reference count.

SetD3ColdSupport

A pointer to a SetD3ColdSupport routine that enables or disables transitions to the D3cold device power state.

GetIdleWakeInfo

A pointer to a GetIdleWakeInfo routine that the device driver calls to discover the device power states from which this device can signal wake events to the processor.

GetD3ColdCapability

A pointer to a GetD3ColdCapability routine that reports whether this device is capable of entering the D3cold device power state.

GetBusDriverD3ColdSupport

A pointer to a GetBusDriverD3ColdSupport routine that reports whether the underlying bus driver and ACPI system firmware support D3cold for this device.

GetLastTransitionStatus

A pointer to a GetLastTransitionStatus routine that reports whether this device's most recent transition to D3hot was followed by a transition to D3cold.

Remarks

A device driver that successfully queries for the GUID_D3COLD_SUPPORT_INTERFACE interface receives a pointer to a D3COLD_SUPPORT_INTERFACE structure in which the pointers to the routines in the interface are all non-NULL and valid.

The D3COLD_SUPPORT_INTERFACE structure is an extended version of the INTERFACE structure.

Requirements

Requirement Value
Minimum supported client Supported starting with Windows 8.
Header wdm.h (include Wdm.h)

See also

GetBusDriverD3ColdSupport

GetD3ColdCapability

GetIdleWakeInfo

GetLastTransitionStatus

INTERFACE

InterfaceDereference

InterfaceReference

SetD3ColdSupport