ACX_JACK_DESCRIPTION struttura (acxpin.h)
La struttura ACX_JACK_DESCRIPTION descrive gli attributi di un jack audio, ad esempio tipo di connessione, posizione fisica e così via.
Sintassi
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;
Members
ChannelMapping
Specifica il mapping dei canali audio alle posizioni dell'altoparlante corrispondente. ChannelMapping è una maschera di bit dei flag di KSAUDIO_SPEAKER_XXX (ad esempio, SPEAKER_FRONT_LEFT | SPEAKER_FRONT_RIGHT), definiti nel file di intestazione Ksmedia.h. ChannelMapping deve essere diverso da zero solo per i pin di rendering analogici. Per i pin di acquisizione o per i pin di rendering digitale, impostare questo membro su 0.
Color
Specifica il colore del jack. Il colore viene espresso come valore RGB a 32 bit formato concatenando i componenti di colore blu, verde e rosso a 8 bit. Il componente blu occupa i bit meno significativi (bit 0-7), il componente verde occupa bit 8-15 e il componente rosso occupa bit a 16-23 bit. I 8 bit più significativi sono zero. Se il colore del jack è sconosciuto o il connettore fisico non ha un colore identificabile, il valore di questo membro è 0x00000000, che rappresenta il nero.
ConnectionType
Specifica il tipo di connessione fisica per questo jack. Il valore di questo membro è uno dei valori di enumerazione EPcxConnectionType illustrati nella tabella seguente.
| Valore | Tipo di connettore |
|---|---|
| eConnTypeUnknown | Sconosciuto |
| eConnType3Point5mm | Minijack da 3,5 mm |
| eConnTypeQuarter | Jack da 1/4 pollici |
| eConnTypeAtapiInternal | Connettore interno ATAPI |
| eConnTypeRCA | Jack RCA |
| eConnTypeOptical | Connettore ottico |
| eConnTypeOtherDigital | Connettore digitale generico |
| eConnTypeOtherAnalog | Connettore analogico generico |
| eConnTypeMultichannelAnalogDIN | Connettore DIN analogico multicanale |
| eConnTypeXlrProfessional | Connettore XLR |
| eConnTypeR11Modem | Connettore modem RJ11 |
| eConnTypeCombination | Combinazione del connettore |
GeoLocation
Posizione geometrica del jack. Il valore di questo membro è uno dei valori di enumerazione EPcxGeoLocation illustrati nella tabella seguente.
| Valore | Posizione geometrica |
|---|---|
| eGeoLocRear | Rear |
| eGeoLocFront | Front |
| eGeoLocLeft | Sinistra |
| eGeoLocRight | Destra |
| eGeoLocTop | TOP |
| eGeoLocBottom | Ultimo |
| eGeoLocRearPanel | Pannello aperto o pull posteriore |
| eGeoLocRiser | Carta riser |
| eGeoLocInsideMobileLid | Coperchio del computer mobile |
| eGeoLocDrivebay | Baia unità |
| eGeoLocHDMI | Connettore HDMI |
| eGeoLocOutsideMobileLid | Coperchio esterno del computer mobile |
| eGeoLocATAPI | Connettore ATAPI |
| eGeoLocNotApplicable | Non applicabile. Vedere la sezione Osservazioni . |
GenLocation
Specifica la posizione generale del jack. Il valore di questo membro è uno dei valori di enumerazione EPcxGenLocation illustrati nella tabella seguente.
| Valore | Posizione generale |
|---|---|
| eGenLocPrimaryBox | Nello chassis primario |
| eGenLocInternal | All'interno dello chassis primario |
| eGenLocSeparate | Nello chassis separato |
| eGenLocOther | Altra posizione |
PortConnection
Specifica il tipo di porta rappresentato dal jack. Il valore di questo membro è uno dei valori di enumerazione EPxcPortConnection illustrati nella tabella seguente.
| Valore | Tipo di connessione della porta |
|---|---|
| ePortConnJack | Jack |
| ePortConnIntegratedDevice | Slot per un dispositivo integrato |
| ePortConnBothIntegratedAndJack | Sia un jack che uno slot per un dispositivo integrato |
| ePortConnUnknown | Sconosciuto |
Commenti
Questa struttura descrive un jack audio che fa parte di una connessione tra un dispositivo endpoint e un dispositivo hardware in una scheda audio. Quando un utente deve collegare un dispositivo endpoint a un jack o scollegarlo da un jack, un'applicazione audio può usare le informazioni descrittive nella struttura per aiutare l'utente a trovare il jack.
Quando un dispositivo audio non espone un jack accessibile fisicamente, il dispositivo audio usa il valore eGeoLocNotApplicable per indicare alle app basate su Windows e Windows che non esiste un jack fisico. Di conseguenza, non c'è alcuna posizione geometrica. Ad esempio, il dispositivo audio può essere integrato nella scheda madre, senza jack accessibili.
Requisiti ACX
Versione minima DI ACX: 1.0
Per altre informazioni sulle versioni ACX, vedere Panoramica della versione di ACX.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | acxpin.h |