GET_D3COLD_LAST_TRANSITION_STATUS callback function (wdm.h)

Article
02/25/2022

The GetLastTransitionStatus routine enables the driver for a device to query whether the most recent transition to the D3hot substate was followed by a transition to the D3cold substate.

Syntax

GET_D3COLD_LAST_TRANSITION_STATUS GetD3coldLastTransitionStatus;

void GetD3coldLastTransitionStatus(
  [in, optional] PVOID Context,
  [out]          PD3COLD_LAST_TRANSITION_STATUS LastTransitionStatus
)
{...}

Parameters

[in, optional] Context

A pointer to interface-specific context information. The caller sets this parameter to the value of the Context member of the D3COLD_SUPPORT_INTERFACE structure for the interface.

[out] LastTransitionStatus

A pointer to a variable into which the routine writes one of the following D3COLD_LAST_TRANSITION_STATUS enumeration values:

LastDStateTransitionStatusUnknown
LastDStateTransitionD3hot
LastDStateTransitionD3cold

The LastDStateTransitionD3cold value indicates that the most recent transition to D3hot was followed by a transition to D3cold. For more information, see Remarks.

Return value

None

Remarks

This routine tries to get the information needed to answer the caller's query from the parent bus driver and platform firmware. If this information is not available, the routine writes the value LastDStateTransitionStatusUnknown to the location pointed to by the LastTransitionStatus parameter.

For more information, see D3COLD_LAST_TRANSITION_STATUS.

Requirements

Requirement	Value
Minimum supported client	Available starting with Windows 8.
Target Platform	Desktop
Header	wdm.h (include Wdm.h)
IRQL	PASSIVE_LEVEL