KsStudio - Filtri e filtri e factory
In questo argomento viene descritto il modo in cui possono essere visualizzati filtri e factory di filtri usando l'utilità KSStudio.
I driver audio WDM (Microsoft Windows Driver Model) rappresentano un dispositivo audio come filtro KS e rappresentano un buffer hardware nel dispositivo come pin nel filtro. Per altre informazioni, vedere Filtro, Pin e Proprietà nodo.
Opzioni di enumerazione KS Filter Factory
Una sessione in KSStudio inizia in genere enumerando le KS Filter Factory installate nel sistema. Per impostazione predefinita, l'utente viene presentato con una finestra di dialogo opzioni di enumerazione all'avvio. Questa finestra di dialogo può essere richiamata in qualsiasi momento dopo l'avvio tramite la barra dei menu (View.Options...).
Esistono due modi in cui KSStudio enumera i filtri:
API di installazione. Questo è per gran parte il mezzo più comune e utile dell'enumerazione factory di filtro. Se una factory di filtro è installata correttamente in un sistema, sarà enumerabile tramite una o più categorie di filtri, ad esempio KSCATEGORY_AUDIO, KSCATEGORY_RENDER e così via. È possibile scegliere quali categorie enumerare, premendo "Classi..." Pulsante. In questo modo viene richiamata una finestra di dialogo che presenta tutte le categorie attualmente dichiarate in KSMedia.h.
In modo esplicito in base al nome del dispositivo. Se l'API di installazione non enumera la factory di filtro, ma il driver viene installato (ad esempio, viene visualizzato senza errore in Gestione dispositivi), potrebbe essere possibile creare un'istanza del dispositivo in modo esplicito in base al nome. Questa operazione viene eseguita immettendo il nome del dispositivo nel controllo di modifica "Filtri aggiuntivi". Questo può risultare utile per la risoluzione dei problemi di enumerazione (ad esempio errori INF).
KSStudio fornisce anche alcuni "Filtri di test", che esistono solo nel programma KSStudio. Questi filtri di test possono essere usati per trasmettere i dati direttamente ai filtri KS, che possono essere utili per la risoluzione dei problemi.
Le factory di filtro installate enumerate da KSStudio vengono visualizzate nella visualizzazione Filter Factory illustrata in Utilità KSStudio.
Filter Factory
Le factory di filtri enumerate vengono visualizzate nella visualizzazione Filter Factory. Una factory di filtro è un facet di un driver WDM che espone un nome di dispositivo che può essere passato a per CreateFile creare un'istanza di un filtro (ovvero un oggetto kernel). Per ogni factory di filtro enumerata, KSStudio visualizza un elenco completo di attributi recuperati usando le API di installazione di Windows, senza creare effettivamente un'istanza del filtro.
L'attributo Nome dispositivo è la stringa passata da CreateFile KSStudio quando l'utente sceglie di creare un'istanza del filtro.
Filtrare l'istanza
Per creare un'istanza di un filtro, fare doppio clic su una factory di filtro nella visualizzazione Filtro factory oppure fare clic con il pulsante destro del mouse su una factory e scegliere crea un'istanza. Se l'istanza ha esito positivo, KSStudio interroga il filtro (tramite una barra delle chiamate delle proprietà) e compila un profilo usando i valori ottenuti. Questo profilo viene usato per generare una rappresentazione grafica dell'istanza del filtro nella visualizzazione topologia oggetto, che viene dedotto dai valori delle proprietà e una rappresentazione testuale nella visualizzazione Dettagli oggetto che mostra i valori effettivi delle proprietà ottenuti.
Per chiudere un filtro, fare clic con il pulsante destro del mouse su di esso e scegliere Chiudi dal menu popup.
Filtri di test
KSStudio include diversi filtri di test o pompe di dati, quindi denominati perché inviano i buffer di dati che vengono riempiti o utilizzati dal grafo del filtro KS.
Pompa di file wave. Questo filtro legge i file con estensione wav e invia i dati ai pin in grado di utilizzare KSDATAFORMAT_TYPE_AUDIO dati.
Pompa file MIDI. Questo filtro legge i file con estensione mid o .rmi e invia i dati ai pin in grado di utilizzare KSDATAFORMAT_TYPE_MUSIC dati.
Pompa di acquisizione onda. Questo filtro invia buffer vuoti ai pin in grado di fornire dati KSDATAFORMAT_AUDIO. I dati vengono visualizzati usando un contatore VU.
Pompa di acquisizione MIDI. Questo filtro invia buffer vuoti ai pin in grado di fornire dati di KSDATAFORMAT_MUSIC. I dati vengono visualizzati nella finestra di registrazione come messaggi MIDI non elaborati e tradotti.
Pompa di flusso full duplex. Questo filtro invia buffer vuoti a un pin KSDATAFLOW_IN e quindi invia nuovamente i dati recuperati in un pin KSDATAFLOW_OUT. Ad esempio, è possibile usare questa pompa per acquisire dati PCM da un pin del microfono e inviarli nuovamente a un pin di rendering.