Compartir a través de

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

  • Artículo

El método SetState 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 siguiente sección Comentarios.

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.

Observaciones

Para un gráfico de filtros de audio, los cuatro KSSTATE valores de enumeración 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 como normal.

  • KSSTATE_ACQUIRE

    Este es un estado transitorio que ayuda a administrar la transición entre KSSTATE_RUN y KSSTATE_STOP.

  • KSSTATE_PAUSE

    Este es 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 miniporte, KSSTATE_ACQUIRE y KSSTATE_PAUSE son indistinguibles.

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

  • STOP -> ACQUIRE -> PAUSE -> RUN
  • EJECUTAR: pausa de>> adquisición>
El método IMiniportWaveCíclico::NewStream establece el estado inicial de la secuencia en KSSTATE_STOP.

Requisitos

Requisito Valor
de la plataforma de destino de Universal
encabezado de portcls.h (incluya Portcls.h)
irQL PASSIVE_LEVEL

Consulte también

IMiniportWaveCíclico::NewStream

IMiniportWaveStreamStream

KSPROPERTY_CONNECTION_STATE

KSSTATE