IMiniportWavePciStream::SetState

The SetState method changes the state of the stream transport.

NTSTATUS
  SetState(
    IN KSSTATE  State
    );

Parameters

State

Specifies the new state of the stream. This parameter is a KSSTATE enumeration value. See the following Comments section.

Return Value

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

Headers

Declared in portcls.h. Include portcls.h.

Comments

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.

The SetState method is called at IRQL PASSIVE_LEVEL.

See Also

KSSTATE, KSPROPERTY_CONNECTION_STATE