Metodo IMXF::SetState (dmusicks.h)
Il metodo SetState viene usato per impostare lo stato dell'interfaccia di trasformazione MIDI.
Sintassi
NTSTATUS SetState(
KSSTATE State
);
Parametri
State
Specifica lo stato su cui deve essere impostato il grafico del filtro. Questo parametro è un valore di enumerazione KSSTATE. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.
Valore restituito
Questo metodo restituisce NTSTATUS che contiene STATUS_SUCCESS se la chiamata ha esito positivo. In caso contrario, il metodo restituisce un codice di errore appropriato.
Commenti
Per un grafico di filtro audio, i quattro valori di enumerazione KSSTATE vengono interpretati come segue:
| Valore | State |
|---|---|
| KSSTATE_RUN | Tutto è in esecuzione e funziona come normale. In questo stato, l'interfaccia IMXF sarà attiva e passerà i messaggi come di consueto. |
| KSSTATE_ACQUIRE | Si tratta di uno stato di transizione che consente di gestire la transizione tra KSSTATE_RUN e KSSTATE_STOP. In questo stato, i messaggi non possono essere passati a valle nel grafico del filtro. |
| KSSTATE_PAUSE | Si tratta di uno stato di transizione che consente di gestire la transizione tra KSSTATE_RUN e KSSTATE_STOP. |
| KSSTATE_STOP | Tutti gli elementi vengono arrestati nel grafico del filtro corrente. |
Il comportamento del driver miniport dipende dallo stato del grafico del filtro. Questo comportamento differisce per il rendering (output) e l'acquisizione (input).
Sul lato output, se lo stato corrente è diverso da KSSTATE_RUN, l'interfaccia IMXF deve contenere i dati e non passarla all'hardware. Se lo stato corrente è KSTATE_STOP, il driver miniport deve eliminare tutti i dati forniti passando tali dati all'allocatore.
Sul lato input, se il flusso di input si trova in KSSTATE_RUN o KSSTATE_PAUSE, è legale che il driver miniport ottenga i messaggi dall'allocatore e li invii a monte al sink di acquisizione. Se lo stato è KSSTATE_STOP o KSSTATE_ACQUIRE e l'hardware sta tentando di produrre dati, tali dati devono essere generati.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | dmusicks.h |
| IRQL | PASSIVE_LEVEL |