IMiniportWavePciStream::SetState method

The SetState method changes the state of the stream transport.

Syntax


NTSTATUS SetState(
  [in]  KSSTATE State
);

Parameters

State [in]

Specifies the new state of the stream. This parameter is a KSSTATE enumeration value. For more information, see the following Remarks section.

Return value

SetState returns STATUS_SUCCESS if the call was successful. Otherwise, the method returns an appropriate error code.

Remarks

For an audio filter graph, the four KSSTATE enumeration values are interpreted as follows:

  • KSSTATE_RUN

    Data transport in the current audio filter graph is running and functioning as normal.

  • KSSTATE_ACQUIRE

    This is a transitional state that helps to manage the transition between KSSTATE_RUN and KSSTATE_STOP.

  • KSSTATE_PAUSE

    This is a transitional state that helps to manage the transition between KSSTATE_RUN and KSSTATE_STOP.

  • KSSTATE_STOP

    Data transport is stopped in the current audio filter graph.

For most miniports, KSSTATE_ACQUIRE and KSSTATE_PAUSE are indistinguishable.

Transitions always occur in one of the following two sequences:

  • STOP -> ACQUIRE -> PAUSE -> RUN

  • RUN -> PAUSE -> ACQUIRE -> STOP

The IMiniportWavePci::NewStream method sets the initial state of the stream to KSSTATE_STOP.

Requirements

Header

Portcls.h (include Portcls.h)

IRQL

PASSIVE_LEVEL

See also

KSSTATE
KSPROPERTY_CONNECTION_STATE
IMiniportWavePci::NewStream

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft