struttura ACX_JACK_DESCRIPTION (acxpin.h)
La struttura ACX_JACK_DESCRIPTION descrive gli attributi di un jack audio, ad esempio il tipo di connessione, la 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;
Membri
ChannelMapping
Specifica il mapping dei canali audio alle posizioni corrispondenti dell'altoparlante. 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 per il rendering digitale, impostare questo membro su 0.
Color
Specifica il colore del jack. Il colore viene espresso come valore RGB a 32 bit formato dalla concatenazione dei componenti di colore blu, verde e rosso a 8 bit. Il componente blu occupa gli 8 bit meno significativi (bit 0-7), il componente verde occupa i bit 8-15 e il componente rosso occupa i bit da 16 a 23. Gli 8 bit più significativi sono zeri. 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 |
| eConnTypeRJ11Modem | Connettore modem RJ11 |
| eConnTypeCombination | Combinazione di connettori |
GeoLocation
Posizione geometrica del jack. Il valore di questo membro è uno dei valori di enumerazione EPcxGeoLocation illustrati nella tabella seguente.
| Valore | Posizione geometrica |
|---|---|
| eGeoLocRear | Posteriore |
| eGeoLocFront | Fronte |
| eGeoLocLeft | A sinistra |
| eGeoLocRight | A destra |
| eGeoLocTop | In alto |
| eGeoLocBottom | Fondoschiena |
| eGeoLocRearPanel | Pannello posteriore aperto o aperto a scorrimento |
| eGeoLocRiser | Carta riser |
| eGeoLocInsideMobileLid | Coperchio interno del computer mobile |
| eGeoLocDrivebay | Baia di 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 | In uno chassis separato |
| eGenLocOther | Altra posizione |
PortConnection
Specifica il tipo di porta rappresentata dal jack. Il valore di questo membro è uno dei valori di enumerazione EPxcPortConnection illustrati nella tabella seguente.
| Valore | Tipo di connessione porta |
|---|---|
| ePortConnJack | Cricco |
| ePortConnIntegratedDevice | Slot per un dispositivo integrato |
| ePortConnBothIntegratedAndJack | Sia un jack che uno slot per un dispositivo integrato |
| ePortConnUnknown | Sconosciuto |
Osservazioni
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 fisicamente accessibile, il dispositivo audio usa il valore eGeoLocNotApplicable per indicare alle app basate su Windows e Windows che non sono presenti jack fisici. Di conseguenza, non esiste neanche una 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 di ACX, vedere panoramica della versione ACX.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | acxpin.h |