Pin Category-Eigenschaft
WdM-Audiotreiber (Microsoft Windows Driver Model) für USB-Audiogeräte, IEEE 1394-Audiogeräte und Audiogeräte in internen Bussen stellen alle ihre Geräte als KS-Filter mit Pins dar. Ein WDM-Audiotreiber verwaltet für jeden unterstützten Pintyp eine KSPIN_DESCRIPTOR-Struktur . In dieser Struktur speichert der Treiber die KSPROPSETID_Pin Eigenschaften des Pintyps. Zu diesen Eigenschaften gehört die KSPROPERTY_PIN_CATEGORY-Eigenschaft . Eine Anforderung für diese Eigenschaft ruft die KS-Pinkategorie-GUID aus dem Category-Member der KSPIN_DESCRIPTOR-Struktur ab. Diese GUID gibt die allgemeine Kategorie der Funktionen an, die der Pin bereitstellt. Beispielsweise identifiziert eine bestimmte PIN-Kategorie-GUID, KSNODETYPE_HEADPHONES, einen Pin als Ausgangsbuchse für Kopfhörer.
Bei einem Waveaudiogerät auf einem internen Bus (z. B. PCI) enthält der PortCls-Miniporttreiber ein Array von Stiftdeskriptoren, die jeweils einen Pintyp im Filter beschreibt, der das Gerät darstellt. Jeder Pindeskriptor ist eine PCPIN_DESCRIPTOR-Struktur , die eine eingebettete KSPIN_DESCRIPTOR-Struktur mit einer PIN-Kategorie-GUID enthält. Beim Empfang einer KSPROPERTY_PIN_CATEGORY-Eigenschaftsanforderung von einem Client ruft der Porttreiber die PIN-Kategorie-GUID aus dem Pindeskriptor des Miniporttreibers für den angegebenen Pintyp ab. Weitere Informationen zu Stiftdeskriptoren finden Sie unter Anheften von Fabriken.
Ein USB-Audiogerät verfügt über eine Reihe von Terminals, über die digitale Streams und analoge Signale in das Gerät ein- und aussteigen können. Beim Erstellen eines KS-Filters, der ein USB-Audiogerät darstellt, übersetzt der USBAudio-Klassensystemtreiber die Anschlüsse des Geräts in Pins am Filter. Die Headerdatei Ksmedia.h definiert eine Zuordnung für jeden USB-Terminaltypbezeichner zu einer GUID der KS-Pinkategorie. In den folgenden sechs Tabellen werden die Terminaltypbezeichner und die entsprechenden PIN-Kategorie-GUIDs angezeigt.
Eingabeterminaltypen
| USB-Terminal-ID | KS Pin Category GUID |
|---|---|
0x0201 |
KSNODETYPE_MICROPHONE |
0x0202 |
KSNODETYPE_DESKTOP_MICROPHONE |
0x0203 |
KSNODETYPE_PERSONAL_MICROPHONE |
0x0204 |
KSNODETYPE_OMNI_DIRECTIONAL_MICROPHONE |
0x0205 |
KSNODETYPE_MICROPHONE_ARRAY |
0x0206 |
KSNODETYPE_PROCESSING_MICROPHONE_ARRAY |
Ausgabeterminaltypen
| USB-Terminal-ID | KS Pin Category GUID |
|---|---|
0x0301 |
KSNODETYPE_SPEAKER |
0x0302 |
KSNODETYPE_HEADPHONES |
0x0303 |
KSNODETYPE_HEAD_MOUNTED_DISPLAY_AUDIO |
0x0304 |
KSNODETYPE_DESKTOP_SPEAKER |
0x0305 |
KSNODETYPE_ROOM_SPEAKER |
0x0306 |
KSNODETYPE_COMMUNICATION_SPEAKER |
0x0307 |
KSNODETYPE_LOW_FREQUENCY_EFFECTS_SPEAKER |
Bidirektionale Terminaltypen
| USB-Terminal-ID | KS Pin Category GUID |
|---|---|
0x0401 |
KSNODETYPE_HANDSET |
0x0402 |
KSNODETYPE_HEADSET |
0x0403 |
KSNODETYPE_SPEAKERPHONE_NO_ECHO_REDUCTION |
0x0404 |
KSNODETYPE_ECHO_SUPPRESSING_SPEAKERPHONE |
0x0405 |
KSNODETYPE_ECHO_CANCELING_SPEAKERPHONE |
Telefonieterminaltypen
| USB-Terminal-ID | KS Pin Category GUID |
|---|---|
0x0501 |
KSNODETYPE_PHONE_LINE |
0x0502 |
KSNODETYPE_TELEPHONE |
0x0503 |
KSNODETYPE_DOWN_LINE_PHONE |
Externe Terminaltypen
| USB-Terminal-ID | KS Pin Category GUID |
|---|---|
0x0601 |
KSNODETYPE_ANALOG_CONNECTOR |
0x0602 |
KSNODETYPE_DIGITAL_AUDIO_INTERFACE |
0x0603 |
KSNODETYPE_LINE_CONNECTOR |
0x0604 |
KSNODETYPE_LEGACY_AUDIO_CONNECTOR |
0x0605 |
KSNODETYPE_SPDIF_INTERFACE |
0x0606 |
KSNODETYPE_1394_DA_STREAM |
0x0607 |
KSNODETYPE_1394_DV_STREAM_SOUNDTRACK |
Eingebettete Funktionsterminaltypen
| USB-Terminal-ID | KS Pin Category GUID |
|---|---|
0x0701 |
KSNODETYPE_LEVEL_CALIBRATION_NOISE_SOURCE |
0x0702 |
KSNODETYPE_EQUALIZATION_NOISE |
0x0703 |
KSNODETYPE_CD_PLAYER |
0x0704 |
KSNODETYPE_DAT_IO_DIGITAL_AUDIO_TAPE |
0x0705 |
KSNODETYPE_DCC_IO_DIGITAL_COMPACT_CASSETTE |
0x0706 |
KSNODETYPE_MINIDISK |
0x0707 |
KSNODETYPE_ANALOG_TAPE |
0x0708 |
KSNODETYPE_PHONOGRAPH |
0x0709 |
KSNODETYPE_VCR_AUDIO |
0x070A |
KSNODETYPE_VIDEO_DISC_AUDIO |
0x070B |
KSNODETYPE_DVD_AUDIO |
0x070C |
KSNODETYPE_TV_TUNER_AUDIO |
0x070D |
KSNODETYPE_SATELLITE_RECEIVER_AUDIO |
0x070E |
KSNODETYPE_CABLE_TUNER_AUDIO |
0x070F |
KSNODETYPE_DSS_AUDIO |
0x0710 |
KSNODETYPE_RADIO_RECEIVER |
0x0711 |
KSNODETYPE_RADIO_TRANSMITTER |
0x0712 |
KSNODETYPE_MULTITRACK_RECORDER |
0x0713 |
KSNODETYPE_SYNTHESIZER |
Weitere Informationen zu USB-Terminaltypbezeichnern finden Sie unter Universal Serial Bus Device Class Definition for Terminal Types (Release 1.0), die auf der Website USB Implementers Forum verfügbar ist.
Alle PIN-Kategorie-GUIDs in den vorherigen Tabellen verfügen über Parameternamen der Form KSNODETYPE_XXX. Beachten Sie, dass KS-Knotentyp-GUIDs auch KSNODETYPE_XXX-Parameternamen aufweisen. Diese Benennungskonvention schafft ein gewisses Verwechslungspotential zwischen PIN-Kategorie-GUIDs und Knotentyp-GUIDs. Glücklicherweise identifiziert fast jeder KSNODETYPE_XXX-Parameter entweder eine Pinkategorie oder einen Knotentyp, aber nicht beides. Die einzige Ausnahme von der Regel ist KSNODETYPE_SYNTHESIZER, die je nach Kontext entweder eine Pinkategorie oder einen Knotentyp identifizieren kann. Eine Liste der Knotentyp-GUIDs finden Sie unter Audiotopologieknoten.
Beim Instanziieren eines USB-Audiogeräts fragt der Systemtreiber der USBAudio-Klasse das Gerät nach seiner internen Topologie ab, einschließlich seiner Terminals. Mit diesen Informationen erstellt der USBAudio-Treiber einen Filter zur Darstellung des Geräts und übersetzt jedes Terminal in einen entsprechenden Pin auf dem Filter. Während dieses Prozesses übersetzt der Treiber jeden USB-Terminaltypbezeichner in die entsprechende KS-Pinkategorie-GUID, die eine der GUIDs in den vorherigen Tabellen ist. Der Treiber erstellt eine KSPIN_DESCRIPTOR-Struktur , um den Pin zu beschreiben, und schreibt die PIN-Kategorie-GUID in die Struktur.
Ein PortCls-Miniporttreiber verwendet nicht unbedingt nur die Kategorien-GUIDs, die in den vorherigen sechs Tabellen angezeigt werden. Beispielsweise kann ein Treiber eine benutzerdefinierte PIN-Kategorie-GUID definieren und verwenden, um einen Pintyp zu beschreiben, dessen Funktionskategorie außerhalb der Kategorien in den Tabellen liegt. Natürlich ist eine GUID für eine benutzerdefinierte Pinkategorie nur für Clients nützlich, die die GUID erkennen.
Das Audiosubsystem verwaltet eine Liste der PIN-Kategorie-GUIDs und der zugehörigen Anzeigenamen in der Systemregistrierung. Das Medienklasseninstallationsprogramm kopiert die GUID-Name-Paare aus der Datei Ks.inf im Unterordner "Inf" des ordners Standard Windows in die Registrierung (z. B. C:\Windows\Inf\Ks.inf).
Das Betriebssystem verwendet Anheftkategorien, um Anzeigenamen Audioendpunktgeräten zuzuordnen. Weitere Informationen zum Zuordnen von Anzeigenamen zu Audioendpunktgeräten finden Sie unter Anzeigenamen für Audioendpunktgeräte.