Metodo IMXF::SetState (dmusicks.h)

Il metodo SetState viene utilizzato 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 avuto 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 di consueto. In questo stato, l'interfaccia IMXF sarà attiva e passerà i messaggi come di consueto.
KSSTATE_ACQUIRE Si tratta di uno stato transitorio che consente di gestire la transizione tra KSSTATE_RUN e KSSTATE_STOP. In questo stato, i messaggi non possono essere passati downstream nel grafico del filtro.
KSSTATE_PAUSE Si tratta di uno stato transitorio che consente di gestire la transizione tra KSSTATE_RUN e KSSTATE_STOP.
KSSTATE_STOP Tutto viene arrestato nel grafico dei filtri corrente.

Il comportamento del driver miniport dipende dallo stato del grafico del filtro. Questo comportamento è diverso 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 possa ricevere messaggi dall'allocatore e inviarli upstream 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

   
Intestazione dmusicks.h
IRQL PASSIVE_LEVEL

Vedi anche

IMXF