KSJACK_DESCRIPTION-Struktur (devicetopology.h)
Die KSJACK_DESCRIPTION-Struktur beschreibt eine Audiobuchse.
Syntax
typedef struct __MIDL___MIDL_itf_devicetopology_0000_0000_0009 {
DWORD ChannelMapping;
COLORREF Color;
EPcxConnectionType ConnectionType;
EPcxGeoLocation GeoLocation;
EPcxGenLocation GenLocation;
EPxcPortConnection PortConnection;
BOOL IsConnected;
} KSJACK_DESCRIPTION, *PKSJACK_DESCRIPTION;
Member
ChannelMapping
Gibt die Zuordnung der beiden Audiokanäle in einer Stereobuchse zu den Lautsprecherpositionen an.
In Windows Vista ist der Wert dieses Members einer der in der folgenden Tabelle gezeigten EChannelMapping-Enumerationswerte .
| Wert | Erster Kanal | Zweiter Kanal |
|---|---|---|
| ePcxChanMap_FL_FR | Lautsprecher vorne links | Front-Right-Lautsprecher |
| ePcxChanMap_FC_LFE | Front-Center-Lautsprecher | Low-Frequency-Effects-Lautsprecher (Subwoofer) |
| ePcxChanMap_BL_BR | Hinterer linker Lautsprecher | Hintere rechte Lautsprecher |
| ePcxChanMap_FLC_FRC | Front-left-Center-Lautsprecher | Front-Right-Center-Lautsprecher |
| ePcxChanMap_SL_SR | Seitlich-links-Lautsprecher | Seitlich-rechts-Lautsprecher |
| ePcxChanMap_Unknown | Unbekannt | Unbekannt |
In Windows 7 ist die EChannelMapping-Enumeration veraltet. Der Datentyp dieses Members ist ein DWORD.The datatype of this member is a DWORD. Dieses Element speichert entweder 0 oder die Bitweise-OR-Kombination eines oder mehrerer der folgenden Werte, die in Ksmedia.h definiert sind.
#define SPEAKER_FRONT_LEFT 0x1
#define SPEAKER_FRONT_RIGHT 0x2
#define SPEAKER_FRONT_CENTER 0x4
#define SPEAKER_LOW_FREQUENCY 0x8
#define SPEAKER_BACK_LEFT 0x10
#define SPEAKER_BACK_RIGHT 0x20
#define SPEAKER_FRONT_LEFT_OF_CENTER 0x40
#define SPEAKER_FRONT_RIGHT_OF_CENTER 0x80
#define SPEAKER_BACK_CENTER 0x100
#define SPEAKER_SIDE_LEFT 0x200
#define SPEAKER_SIDE_RIGHT 0x400
#define SPEAKER_TOP_CENTER 0x800
#define SPEAKER_TOP_FRONT_LEFT 0x1000
#define SPEAKER_TOP_FRONT_CENTER 0x2000
#define SPEAKER_TOP_FRONT_RIGHT 0x4000
#define SPEAKER_TOP_BACK_LEFT 0x8000
#define SPEAKER_TOP_BACK_CENTER 0x10000
#define SPEAKER_TOP_BACK_RIGHT 0x20000
Color
Die Jack-Farbe. 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 Connector keine identifizierbare Farbe hat, ist der Wert dieses Members 0x00000000, der schwarz ist.
ConnectionType
Der Verbindungstyp. Der Wert dieses Members ist einer der in der folgenden Tabelle gezeigten EPcxConnectionType-Enumerationswerte .
| Wert | Connectortyp |
|---|---|
| eConnTypeUnknown | Unbekannt |
|
eConnTypeEighth (Windows Vista) eConnType3Point5mm (Windows 7) |
1/8-Zoll-Buchse |
| 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 | Kombination von Connectortypen |
GeoLocation
Die geometrische Position der Jack. Der Wert dieses Members ist einer der in der folgenden Tabelle gezeigten EPcxGeoLocation-Enumerationswerte .
| Wert | Geometrische Position |
|---|---|
| eGeoLocRear | Rückseitig montiertes Panel |
| eGeoLocFront | Frontseitig montiertes Panel |
| eGeoLocLeft | Links montiertes Panel |
| eGeoLocRight | Rechts montiertes Panel |
| eGeoLocTop | Oben montiertes Panel |
| eGeoLocBottom | Unten montiertes Panel |
|
eGeoLocRearOPanel(Windows Vista) eGeoLocRearPanel(Windows 7) |
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 |
GenLocation
Die allgemeine Position der Buchse. 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 |
|
eGenLocSeperate(Windows Vista) eGenLocSeparate(Windows 7) |
Auf separatem Chassis |
| eGenLocOther | Anderer Standort |
PortConnection
Der Porttyp, 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
Wenn der Audioadapter die Erkennung von Klinken an der Buchse unterstützt, gibt der Wert von IsConnected an, ob ein Endpunktgerät an die Buchse angeschlossen ist. Wenn IsConnectedTRUE ist, wird ein Gerät angeschlossen. Wenn es FALSE ist, ist die Buchse leer. Für Geräte, die die Erkennung von Jack-Presence nicht unterstützen, ist dieser Member immer TRUE. Weitere Informationen zur Jack-Presence-Erkennung finden Sie unter Audioendpunktgeräte.
Hinweise
Diese Struktur wird von der IKsJackDescription::GetJackDescription-Methode in der DeviceTopology-API 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.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Kopfzeile | devicetopology.h |