ACX_JACK_DESCRIPTION-Struktur (acxpin.h)

Die ACX_JACK_DESCRIPTION-Struktur beschreibt Attribute einer Audiobuchse, z. B. Verbindungstyp, physischer Standort usw.

Syntax

typedef struct _ACX_JACK_DESCRIPTION {
  ULONG                    ChannelMapping;
  ULONG                    Color;
  ACX_JACK_CONNECTION_TYPE ConnectionType;
  ACX_JACK_GEO_LOCATION    GeoLocation;
  ACX_JACK_GEN_LOCATION    GenLocation;
  ACX_JACK_PORT_CONNECTION PortConnection;
} ACX_JACK_DESCRIPTION, *PACX_JACK_DESCRIPTION;

Member

ChannelMapping

Gibt die Zuordnung der Audiokanäle zu den entsprechenden Lautsprecherpositionen 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 nichtzero sein. Legen Sie für Aufnahmepins oder für digitale Renderingpins dieses Element auf 0 fest.

Color

Gibt die Jackenfarbe an. Die Farbe wird als 32-Bit-RGB-Wert ausgedrückt, der durch Verkettung der 8-Bit-Farbkomponenten blau, grün und rot gebildet wird. Die blaue Komponente belegt die 8 kleinsten Bits (Bits 0-7), die grüne Komponente die Bits 8 bis 15 und die rote Komponente die Bits 16 bis 23. Die 8 wichtigsten Bits sind Nullen. Wenn die Jackenfarbe unbekannt ist oder der physische Anschluss keine identifizierbare Farbe hat, ist der Wert dieses Elements 0x00000000, was schwarz darstellt.

ConnectionType

Gibt den physischen Verbindungstyp für diese Buchse an. Der Wert dieses Members ist einer der EPcxConnectionType-Enumerationswerte , die in der folgenden Tabelle angezeigt werden.

Wert Connectortyp
eConnTypeUnknown Unbekannt
eConnType3Point5mm 3,5 mm Minijack
eConnTypeQuarter 1/4-Zoll-Klinke
eConnTypeAtapiInternal INTERNER ATAPI-Connector
eConnTypeRCA Rca-Buchse
eConnTypeOptical Optischer Anschluss
eConnTypeOtherDigital Generischer digitaler Connector
eConnTypeOtherAnalog Generischer analoger Connector
eConnTypeMultichannelAnalogDIN Mehrkanal-Analog-DIN-Anschluss
eConnTypeXlrProfessional XLR-Connector
eConnTypeRJ11Modem RJ11-Modemanschluss
eConnTypeCombination Verbinderkombination

GeoLocation

Die geometrische Position der Jacke. Der Wert dieses Members ist einer der EPcxGeoLocation-Enumerationswerte , die in der folgenden Tabelle dargestellt sind.

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 den allgemeinen Speicherort der Buchse an. Der Wert dieses Members ist einer der in der folgenden Tabelle gezeigten EPcxGenLocation-Enumerationswerte .

Wert Allgemeiner Standort
eGenLocPrimaryBox Auf primärem Chassis
eGenLocInternal Innerhalb des primären Gehäuses
eGenLocSeparate Auf separatem Chassis
eGenLocOther Anderer Standort

PortConnection

Gibt den Typ des Ports an, der von der 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

Hinweise

Diese Struktur 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 den Benutzer bei der Suche nach der Buchse zu unterstützen.

Wenn ein Audiogerät keine physisch zugängliche Buchse verfügbar macht, verwendet das Audiogerät den eGeoLocNotApplicable-Wert , um Windows- und Windows-basierten Apps anzugeben, dass keine physische Buchse vorhanden ist. Daher gibt es auch keinen geometrischen Ort. Beispielsweise kann das Audiogerät ohne zugängliche Buchsen in die Hauptplatine integriert werden.

ACX-Anforderungen

ACX-Mindestversion: 1.0

Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.

Anforderungen

Anforderung Wert
Header acxpin.h

Weitere Informationen