Método IMXF::SetState (dmusicks.h)

El método SetState se usa para establecer el estado de la interfaz de transformación MIDI.

Sintaxis

NTSTATUS SetState(
  KSSTATE State
);

Parámetros

State

Especifica el estado en el que se va a establecer el gráfico de filtro. 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

Este método devuelve NTSTATUS que contiene 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:

Valor	State
KSSTATE_RUN	Todo funciona y funciona de la forma normal. En este estado, la interfaz IMXF estará activa y pasará mensajes como de costumbre.
KSSTATE_ACQUIRE	Se trata de un estado transitorio que ayuda a administrar la transición entre KSSTATE_RUN y KSSTATE_STOP. En este estado, los mensajes no se pueden pasar de bajada en el gráfico de filtros.
KSSTATE_PAUSE	Se trata de un estado transitorio que ayuda a administrar la transición entre KSSTATE_RUN y KSSTATE_STOP.
KSSTATE_STOP	Todo se detiene en el gráfico de filtro actual.

El comportamiento del controlador de minipuerto depende del estado del gráfico de filtro. Este comportamiento difiere para la representación (salida) y la captura (entrada).

En el lado de salida, si el estado actual es distinto de KSSTATE_RUN, la interfaz IMXF debe contener los datos y no pasarlo al hardware. Si el estado actual es KSTATE_STOP, el controlador de minipuerto debe descartar los datos que se proporcionan pasando esos datos al asignador.

En el lado de entrada, si el flujo de entrada está en KSSTATE_RUN o en KSSTATE_PAUSE, es legal que el controlador de miniporte obtenga mensajes del asignador y envíelos ascendentes al receptor de captura. Si el estado es KSSTATE_STOP o KSSTATE_ACQUIRE y el hardware está intentando generar datos, esos datos deben eliminarse.

Requisitos

Requisito	Valor
Header	dmusicks.h
IRQL	PASSIVE_LEVEL

Consulte también

IMXF