IMiniportWavePciStream::SetState method (portcls.h)

The SetState method changes the state of the stream transport.

Syntax

NTSTATUS SetState(
  [in] KSSTATE State
);

[in] State

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

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

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:

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