Freigeben über


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)

Siehe auch

KSPROPERTY_JACK_DESCRIPTION

KSPROPERTY_JACK_DESCRIPTION2

KSPROPERTY_JACK_DESCRIPTION3