KSJACK_DESCRIPTION struttura
La struttura KSJACK_DESCRIPTION specifica gli attributi fisici di un jack audio.
Sintassi
typedef struct {
DWORD ChannelMapping;
DWORD Color;
EPcxConnectionType ConnectionType;
EPcxGeoLocation GeoLocation;
EPcxGenLocation GenLocation;
EPxcPortConnection PortConnection;
BOOL IsConnected;
} KSJACK_DESCRIPTION, *PKSJACK_DESCRIPTION;
Members
ChannelMapping
Specifica il mapping dei canali audio alle posizioni dell'altoparlante corrispondente. ChannelMapping è una maschera di bit dei flag 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.
Nota
Devicetopology.h originariamente definito ChannelMapping come enumerazione di tipo EChannelMapping. L'enumerazione EChannelMapping è stata deprecata e non viene più usata in Windows Vista e versioni successive dei sistemi operativi Windows.
Colore
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 |
Geolocalizzazione
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 |
IsConnected
Indica se è presente un dispositivo esterno connesso al jack. Se il controller audio supporta il rilevamento jack su questo pin, il valore di IsConnected deve indicare in modo accurato se il jack è occupato da un plug in qualsiasi momento. Questo valore deve essere sempre impostato su TRUE per i dispositivi che non supportano il rilevamento jack.
Commenti
Questa struttura viene usata dalla proprietà KSPROPERTY_JACK_DESCRIPTION in Windows Vista e versioni successive. 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
Intestazione |
Ksmedia.h (includere Ksmedia.h) |