GetLastTransitionStatus routine

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


VOID GetLastTransitionStatus(
  _In_opt_  PVOID Context,
  _Out_     PD3COLD_LAST_TRANSITION_STATUS LastTransitionStatus
);

Parameters

Context [in, optional]

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.

LastTransitionStatus [out]

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

Version

Available starting with Windows 8.

Header

Wdm.h (include Wdm.h)

IRQL

PASSIVE_LEVEL

See also

D3COLD_LAST_TRANSITION_STATUS
D3COLD_SUPPORT_INTERFACE

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft