KSJACK_DESCRIPTION struttura (devicetopology.h)
La struttura KSJACK_DESCRIPTION descrive un jack audio.
Sintassi
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;
Members
ChannelMapping
Specifica il mapping dei due canali audio in un jack stereo per le posizioni dell'altoparlante.
In Windows Vista il valore di questo membro è uno dei valori di enumerazione EChannelMapping illustrati nella tabella seguente.
| Valore | Primo canale | Secondo canale |
|---|---|---|
| ePcxChanMap_FL_FR | Altoparlante front-sinistra | Altoparlante front-destra |
| ePcxChanMap_FC_LFE | Altoparlante centrale anteriore | Altoparlante a bassa frequenza (bass-frequency-effects) |
| ePcxChanMap_BL_BR | Altoparlante indietro sinistro | Altoparlanti back-right |
| ePcxChanMap_FLC_FRC | Altoparlante front-left-center | Relatore front-right-center |
| ePcxChanMap_SL_SR | Altoparlante lato sinistro | Altoparlante a destra |
| ePcxChanMap_Unknown | Sconosciuto | Sconosciuto |
In Windows 7 l'enumerazione EChannelMapping è stata deprecata. Il tipo di dati di questo membro è un DWORD. Questo membro archivia 0 o la combinazione bit per bit-OR di uno o più dei valori seguenti definiti in Ksmedia.h.
#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
Colore 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 colore identificabile, il valore di questo membro è 0x00000000, che è nero.
ConnectionType
Tipo di connessione. Il valore di questo membro è uno dei valori di enumerazione EPcxConnectionType illustrati nella tabella seguente.
| Valore | Tipo di connettore |
|---|---|
| eConnTypeUnknown | Sconosciuto |
|
eConnTypeEighth (Windows Vista) eConnType3Point5mm (Windows 7) |
Jack da 1/8 pollici |
| 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 di tipi di 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 | Pannello montato indietro |
| eGeoLocFront | Pannello montato front-end |
| eGeoLocLeft | Pannello montato a sinistra |
| eGeoLocRight | Pannello montato a destra |
| eGeoLocTop | Pannello montato in alto |
| eGeoLocBottom | Pannello montato in basso |
|
eGeoLocRearOPanel(Windows Vista) eGeoLocRearPanel(Windows 7) |
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 |
GenLocation
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 |
|
eGenLocSeperate(Windows Vista) eGenLocSeparate(Windows 7) |
Nello chassis separato |
| eGenLocOther | Altra posizione |
PortConnection
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 della porta |
|---|---|
| ePortConnJack | Jack |
| ePortConnIntegratedDevice | Slot per un dispositivo integrato |
| ePortConnBothIntegratedAndJack | Sia un jack che uno slot per un dispositivo integrato |
| ePortConnUnknown | Sconosciuto |
IsConnected
Se l'adattatore audio supporta il rilevamento della presenza jack sul jack, il valore di IsConnected indica se un dispositivo endpoint è collegato al jack. Se IsConnected è TRUE, un dispositivo è collegato. Se è FALSE, il jack è vuoto. Per i dispositivi che non supportano il rilevamento della presenza jack, questo membro è sempre TRUE. Per altre informazioni sul rilevamento della presenza jack, vedere Dispositivi endpoint audio.
Commenti
Questa struttura viene usata dal metodo IKsJackDescription::GetJackDescriptionnell'API DeviceTopology. 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.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Intestazione | devicetopology.h |