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)

Vedere anche

KSPROPERTY_JACK_DESCRIPTION

KSPROPERTY_JACK_DESCRIPTION2

KSPROPERTY_JACK_DESCRIPTION3