Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

D3COLD_SUPPORT_INTERFACE structure (wdm.h)

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


Feedback

Was this page helpful?

Additional resources