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) |