Método IMiniportWaveCíclicaStream::SetState (portcls.h)

Artículo
08/07/2023

El SetState método establece el nuevo estado de reproducción o grabación de la secuencia.

Sintaxis

NTSTATUS SetState(
  [in] KSSTATE State
);

Parámetros

[in] State

Especifica el nuevo estado de 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.

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