Compartir a través de

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

  • Artículo

El SetState método cambia el estado del transporte 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 miniportes, KSSTATE_ACQUIRE y KSSTATE_PAUSE son indistinguibles.

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

  • STOP -> ACQUIRE -> PAUSE -> RUN
  • RUN -> PAUSE -> ACQUIRE -> STOP
El método IMiniportWavePci::NewStream establece el estado inicial de la secuencia en KSSTATE_STOP.

Requisitos

Requisito Value
Plataforma de destino Universal
Encabezado portcls.h (incluya Portcls.h)
IRQL PASSIVE_LEVEL

Consulte también

IMiniportWavePci::NewStream

IMiniportWavePciStream

KSPROPERTY_CONNECTION_STATE

KSSTATE