GET_D3COLD_LAST_TRANSITION_STATUS callback function (wdm.h)

  • Article

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

See also

D3COLD_LAST_TRANSITION_STATUS

D3COLD_SUPPORT_INTERFACE