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 |