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.

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.

GeoLocation

Posizione geometrica del jack. Il valore di questo membro è uno dei valori di enumerazione EPcxGeoLocation illustrati nella tabella seguente.

GenLocation

Posizione generale del jack. Il valore di questo membro è uno dei valori di enumerazione EPcxGenLocation illustrati nella tabella seguente.

PortConnection

Tipo di porta rappresentata dal jack. Il valore di questo membro è uno dei valori di enumerazione EPxcPortConnection illustrati nella tabella seguente.

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

Vedi anche

Strutture audio principali

IKsJackDescription::GetJackDescription