KSJACK_DESCRIPTION-Struktur
Die KSJACK_DESCRIPTION-Struktur gibt die physischen Attribute einer Audiobuchse an.
Syntax
typedef struct {
DWORD ChannelMapping;
DWORD Color;
EPcxConnectionType ConnectionType;
EPcxGeoLocation GeoLocation;
EPcxGenLocation GenLocation;
EPxcPortConnection PortConnection;
BOOL IsConnected;
} KSJACK_DESCRIPTION, *PKSJACK_DESCRIPTION;
Member
ChannelMapping
Gibt die Zuordnung der Audiokanäle zu den entsprechenden Sprecherpositionen an. ChannelMapping ist eine Bitmaske der KSAUDIO_SPEAKER_XXX-Flags (z. B. SPEAKER_FRONT_LEFT | SPEAKER_FRONT_RIGHT), die in der Headerdatei Ksmedia.h definiert sind. ChannelMapping sollte nur für analoge Renderingpins ungleich null sein. Legen Sie für Aufnahmepins oder für digitale Rendering-Pins diesen Member auf 0 fest.
Hinweis
Devicetopology.h hat ChannelMapping ursprünglich als Enumeration des Typs EChannelMapping definiert. Die EChannelMapping-Enumeration ist inzwischen veraltet und wird in Windows Vista und höheren Versionen der Windows-Betriebssysteme nicht mehr verwendet.
Farbe
Gibt die Jack-Farbe an. Die Farbe wird als 32-Bit-RGB-Wert ausgedrückt, der durch Verkettung der 8-Bit-Blau-, Grün- und Rotfarbenkomponenten gebildet wird. Die blaue Komponente belegt die 8 kleinsten Bits (Bits 0-7), die grüne Komponente die Bits 8-15 und die rote Komponente die Bits 16 bis 23. Die 8 wichtigsten Bits sind Nullen. Wenn die Farbe der Buchse unbekannt ist oder der physische Verbinder keine identifizierbare Farbe hat, ist der Wert dieses Elements 0x00000000, der Schwarz darstellt.
ConnectionType
Gibt den physischen Verbindungstyp für diese Buchse an. Der Wert dieses Members ist einer der in der folgenden Tabelle gezeigten EPcxConnectionType-Enumerationswerte .
| Wert | Connectortyp |
|---|---|
eConnTypeUnknown |
Unbekannt |
eConnType3Point5mm |
3,5 mm Minijack |
eConnTypeQuarter |
1/4-Zoll-Buchse |
eConnTypeAtapiInternal |
Interner ATAPI-Connector |
eConnTypeRCA |
RCA-Buchse |
eConnTypeOptical |
Optischer Stecker |
eConnTypeOtherDigital |
Generischer digitaler Connector |
eConnTypeOtherAnalog |
Generischer analoger Connector |
eConnTypeMultichannelAnalogDIN |
Multikanal-Analog-DIN-Anschluss |
eConnTypeXlrProfessional |
XLR-Connector |
eConnTypeRJ11Modem |
RJ11-Modemstecker |
eConnTypeCombination |
Connector-Kombination |
Geolocation
Die geometrische Position der Jack. Der Wert dieses Members ist einer der in der folgenden Tabelle gezeigten EPcxGeoLocation-Enumerationswerte .
| Wert | Geometrische Position |
|---|---|
eGeoLocRear |
Rear |
eGeoLocFront |
Front |
eGeoLocLeft |
Left |
eGeoLocRight |
Right |
eGeoLocTop |
Oben |
eGeoLocBottom |
Unten |
eGeoLocRearPanel |
Rückwärtige Schiebe- oder Pull-Open-Panel |
eGeoLocRiser |
Riser-Karte |
eGeoLocInsideMobileLid |
Innendeckel des mobilen Computers |
eGeoLocDrivebay |
Laufwerksschacht |
eGeoLocHDMI |
HDMI-Anschluss |
eGeoLocOutsideMobileLid |
Außendeckel des mobilen Computers |
eGeoLocATAPI |
ATAPI-Connector |
eGeoLocNotApplicable |
Nicht zutreffend. Weitere Informationen finden Sie im Abschnitt "Hinweise ". |
GenLocation
Gibt die allgemeine Position der Buchse an. Der Wert dieses Members ist einer der in der folgenden Tabelle gezeigten EPcxGenLocation-Enumerationswerte .
| Wert | Allgemeiner Standort |
|---|---|
eGenLocPrimaryBox |
Auf dem primären Gehäuse |
eGenLocInternal |
Innerhalb des primären Gehäuses |
eGenLocSeparate |
Auf separatem Gehäuse |
eGenLocOther |
Anderer Standort |
PortConnection
Gibt den Porttyp an, der durch die Buchse dargestellt wird. Der Wert dieses Members ist einer der in der folgenden Tabelle gezeigten EPxcPortConnection-Enumerationswerte .
| Wert | Portverbindungstyp |
|---|---|
ePortConnJack |
Jack |
ePortConnIntegratedDevice |
Slot für ein integriertes Gerät |
ePortConnBothIntegratedAndJack |
Sowohl eine Buchse als auch ein Steckplatz für ein integriertes Gerät |
ePortConnUnknown |
Unbekannt |
Isconnected
Gibt an, ob ein externes Gerät an die Buchse angeschlossen ist. Wenn der Audiocontroller die Klinkenerkennung an diesem Pin unterstützt, sollte der Wert von IsConnected genau angeben, ob die Buchse zu einem bestimmten Zeitpunkt von einem Stecker belegt ist. Dieser Wert sollte für Geräte, die keine Klinkenerkennung unterstützen, immer auf TRUE festgelegt werden.
Hinweise
Diese Struktur wird von der KSPROPERTY_JACK_DESCRIPTION-Eigenschaft in Windows Vista und höher verwendet. Es beschreibt eine Audiobuchse, die Teil einer Verbindung zwischen einem Endpunktgerät und einem Hardwaregerät in einem Audioadapter ist. Wenn ein Benutzer ein Endpunktgerät an eine Buchse anschließen oder es von einer Buchse trennen muss, kann eine Audioanwendung die beschreibenden Informationen in der Struktur verwenden, um dem Benutzer bei der Suche nach der Buchse zu helfen.
Wenn ein Audiogerät keine physisch zugängliche Buchse verfügbar macht, verwendet das Audiogerät den Wert eGeoLocNotApplicable , um Windows- und Windows-basierten Apps anzugeben, dass es keine physische Buchse gibt. Daher gibt es auch keinen geometrischen Ort. Beispielsweise kann das Audiogerät ohne zugängliche Buchsen in die Hauptplatine integriert werden.
Anforderungen
Header |
Ksmedia.h (include Ksmedia.h) |