Pin-Kategorie-Eigenschaft

Microsoft Windows Driver Model (WDM)-Audiotreiber für USB-Audiogeräte, IEEE 1394-Audiogeräte und Audiogeräte auf internen Bussen stellen alle ihre Geräte als KS-Filter mit Pins dar. Ein WDM-Audiotreiber verwaltet eine KSPIN_DESCRIPTOR Struktur für jeden unterstützten Pintyp. Innerhalb 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-Pin-Kategorie-GUID aus dem Member "Category" der KSPIN_DESCRIPTOR Struktur ab. Diese GUID gibt die allgemeine Kategorie der Funktionalität an, die der Pin bereitstellt. Beispielsweise identifiziert eine spezifische PIN-Kategorie-GUID, KSNODETYPE_HEADPHONES, einen Pin als Ausgabebuchse für Kopfhörer.

Im Falle eines Wave-Audiogeräts auf einem internen Bus (z. B. PCI) enthält der PortCls-Miniporttreiber ein Array von Pindeskriptoren, von denen jeder 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 über Pindeskriptoren finden Sie in Pin Factories.

Ein USB-Audiogerät verfügt über eine Reihe von Terminals, über die digitale Datenströme und analoge Signale in das Gerät gelangen und verlassen können. Beim Erstellen eines KS-Filters zur Darstellung eines USB-Audiogeräts übersetzt der USBAudio-Klassensystemtreiber die Terminals auf dem Gerät in Pins auf dem Filter. Die Headerdatei Ksmedia.h definiert eine Zuordnung für jeden USB-Terminaltypbezeichner zu einer KS-Pin-Kategorie-GUID. Die folgenden sechs Tabellen zeigen die Terminaltyp-IDs und die entsprechenden PIN-Kategorie-GUIDs.

Eingabeterminaltypen

Ausgabeterminaltypen

Bidirektionale Terminaltypen

Telefonieterminaltypen

Externe Terminaltypen

Eingebettete Funktionsterminaltypen

Weitere Informationen zu USB-Terminaltyp-IDs finden Sie in der Definition der Universal Serial Bus Device Class für Terminaltypen (Version 1.0), die auf der Website des USB Implementers Forum verfügbar ist.

Alle PIN-Kategorie-GUIDs in den vorherigen Tabellen weisen Parameternamen des Formulars KSNODETYPE_XXX auf. 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 beide. Die einzige Ausnahme der Regel ist KSNODETYPE_SYNTHESIZER, die abhängig vom 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 USBAudio-Klassensystemtreiber das Gerät nach seiner internen Topologie ab, einschließlich seiner Terminals. Mit diesen Informationen erstellt der USBAudio-Treiber einen Filter, der das Gerät darstellt, und übersetzt jedes Terminal in einen entsprechenden Pin auf dem Filter. Während dieses Vorgangs übersetzt der Treiber jeden USB-Terminaltypbezeichner in die entsprechende KS-Pin-Kategorie-GUID, die eine der GUIDs in den vorherigen Tabellen ist. Der Treiber erstellt eine KSPIN_DESCRIPTOR Struktur zur Beschreibung des Pins und schreibt die PIN-Kategorie-GUID in die Struktur.

Ein PortCls-Miniporttreiber verwendet nicht unbedingt nur die Kategorie-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 funktionale Kategorie außerhalb der Kategorien in den Tabellen liegt. Natürlich ist eine benutzerdefinierte PIN-Kategorie-GUID 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 Installationsprogramm für Medienklassen kopiert die GUID-Namen-Paare aus der Datei "Ks.inf", die sich im Unterordner "Inf" des Windows-Hauptordners befindet (z. B. C:\Windows\Inf\Ks.inf), in die Registrierung.

Das Betriebssystem verwendet Pinkategorien, um benutzerfreundliche Namen mit Audioendpunktgeräten zu verknüpfen. Weitere Informationen über das Zuordnen von benutzerfreundlichen Namen zu Audioendpunktgeräten finden Sie unter "Anzeigenamen für Audioendpunktgeräte".