Método IMiniportMidiStream::SetState (portcls.h)

Artículo
08/07/2023

El SetState método establece el estado de transporte del flujo en un nuevo valor de estado.

Sintaxis

NTSTATUS SetState(
  [in] KSSTATE State
);

Parámetros

[in] State

Especifica el nuevo estado en el que se va a establecer la secuencia. Este parámetro es un valor de enumeración KSSTATE . Para obtener más información, vea la sección Comentarios que se muestra más adelante.

Valor devuelto

SetState devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, el método devuelve un código de error adecuado.

Comentarios

Para un gráfico de filtros de audio, los cuatro valores de enumeración KSSTATE se interpretan de la siguiente manera:

KSSTATE_RUN
El transporte de datos en el gráfico de filtros de audio actual se está ejecutando y funcionando de la forma normal.
KSSTATE_ACQUIRE
Se trata de un estado transitorio que ayuda a administrar la transición entre KSSTATE_RUN y KSSTATE_STOP.
KSSTATE_PAUSE
Se trata de un estado transitorio que ayuda a administrar la transición entre KSSTATE_RUN y KSSTATE_STOP.
KSSTATE_STOP
El transporte de datos se detiene en el gráfico de filtros de audio actual.

Para la mayoría de los controladores de minipuerto, KSSTATE_ACQUIRE y KSSTATE_PAUSE son indistinguibles. El método IMiniportMidi::NewStream establece el estado inicial de la secuencia en KSSTATE_STOP.

Las transiciones siempre se producen en una de las dos secuencias siguientes: