Pin Category, proprietà

I driver audio di Microsoft Windows Driver Model (WDM) per i dispositivi audio USB, i dispositivi audio IEEE 1394 e i dispositivi audio nei bus interni rappresentano tutti i dispositivi come filtri KS con pin. Un driver audio WDM mantiene una struttura KSPIN_DESCRIPTOR per ogni tipo di pin supportato. All'interno di questa struttura, il driver archivia le proprietà KSPROPSETID_Pin del tipo di pin. Tra queste proprietà è presente la proprietà KSPROPERTY_PIN_CATEGORY . Una richiesta per questa proprietà recupera il GUID della categoria di pin KS dal membro Category della struttura KSPIN_DESCRIPTOR. Questo GUID indica la categoria generale di funzionalità fornita dal pin. Ad esempio, un PARTICOLARE GUID della categoria di pin, KSNODETYPE_HEADPHONES, identifica un pin come jack di output per le cuffie.

Nel caso di un dispositivo audio wave su un bus interno (ad esempio, PCI), il driver miniport PortCls contiene una matrice di descrittori pin, ognuno dei quali descrive un tipo di pin nel filtro che rappresenta il dispositivo. Ogni descrittore di pin è una struttura PCPIN_DESCRIPTOR contenente una struttura KSPIN_DESCRIPTOR incorporata con un GUID di categoria pin. Dopo aver ricevuto una richiesta di proprietà KSPROPERTY_PIN_CATEGORY da un client, il driver della porta recupera il GUID della categoria di pin dal descrittore pin del driver miniport per il tipo di pin specificato. Per altre informazioni sui descrittori pin, vedere Pin Factory.

Un dispositivo audio USB ha un certo numero di terminali attraverso i quali i flussi digitali e i segnali analogici possono entrare e uscire dal dispositivo. Quando si costruisce un filtro KS per rappresentare un dispositivo audio USB, il driver di sistema della classe USBAudio converte i terminali nel dispositivo in puntini sul filtro. Il file di intestazione Ksmedia.h definisce un mapping per ogni identificatore del tipo di terminale USB a un GUID della categoria di pin KS. Le sei tabelle seguenti illustrano gli identificatori del tipo di terminale e i GUID della categoria di pin corrispondenti.

Tipi di terminale di input

Tipi di terminale di output

Tipi di terminale bidirezionali

Tipi di terminale di telefonia

Tipi di terminale esterni

Tipi di terminale di funzioni incorporate

Per altre informazioni sugli identificatori del tipo di terminale USB, vedere la definizione della classe di dispositivo del bus seriale universale per i tipi di terminale (versione 1.0), disponibile nel sito Web del forum degli implementatori USB .

Tutti i GUID delle categorie di pin nelle tabelle precedenti hanno nomi di parametro del modulo KSNODETYPE_XXX. Si noti che anche i GUID del tipo di nodo KS hanno nomi di parametri KSNODETYPE_XXX . Questa convenzione di denominazione crea una certa confusione tra GUID di categoria pin e GUID del tipo di nodo. Fortunatamente, quasi ogni parametro KSNODETYPE_XXX identifica una categoria pin o un tipo di nodo, ma non entrambi. L'unica eccezione alla regola è KSNODETYPE_SYNTHESIZER, che può identificare una categoria di pin o un tipo di nodo, a seconda del contesto. Per un elenco dei GUID di tipo di nodo, vedere Nodi topologia audio.

Quando si crea un'istanza di un dispositivo audio USB, il driver di sistema della classe USBAudio esegue una query sul dispositivo per la topologia interna, inclusi i terminali. Con queste informazioni, il driver USBAudio costruisce un filtro per rappresentare il dispositivo e converte ogni terminale in un pin corrispondente nel filtro. Durante questo processo, il driver converte ogni identificatore del tipo di terminale USB nel GUID della categoria di pin KS corrispondente, che è uno dei GUID nelle tabelle precedenti. Il driver costruisce una struttura KSPIN_DESCRIPTOR per descrivere il pin e scrive il GUID della categoria di pin nella struttura.

Un driver miniport PortCls non usa necessariamente solo i GUID di categoria visualizzati nelle sei tabelle precedenti. Ad esempio, un driver può definire e usare un GUID di categoria pin personalizzato per descrivere un tipo di pin la cui categoria funzionale non rientra nelle categorie nelle tabelle. Naturalmente, un GUID di categoria di pin personalizzato è utile solo per i client che riconoscono il GUID.

Il sottosistema audio gestisce un elenco di GUID delle categorie di pin e i nomi descrittivi associati nel Registro di sistema. Il programma di installazione della classe multimediale copia le coppie GUID-name nel Registro di sistema dal file Ks.inf che si trova nella sottocartella Inf della cartella principale di Windows (ad esempio, C:\Windows\Inf\Ks.inf).

Il sistema operativo usa le categorie di pin per associare nomi descrittivi ai dispositivi endpoint audio. Per altre informazioni su come associare nomi descrittivi ai dispositivi endpoint audio, vedere Nomi descrittivi per dispositivi endpoint audio.