struktur KSJACK_DESCRIPTION (devicetopology.h)
Struktur KSJACK_DESCRIPTION menggambarkan jack audio.
Sintaks
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;
Anggota
ChannelMapping
Menentukan pemetaan dua saluran audio dalam jack stereo ke posisi speaker.
Di Windows Vista, nilai anggota ini adalah salah satu nilai enumerasi EChannelMapping yang diperlihatkan dalam tabel berikut ini.
| Nilai | Saluran pertama | Saluran kedua |
|---|---|---|
| ePcxChanMap_FL_FR | Speaker kiri depan | Speaker kanan depan |
| ePcxChanMap_FC_LFE | Speaker tengah depan | Speaker efek frekuensi rendah (subwoofer) |
| ePcxChanMap_BL_BR | Speaker kiri belakang | Speaker kanan belakang |
| ePcxChanMap_FLC_FRC | Speaker tengah depan-kiri | Speaker tengah kanan depan |
| ePcxChanMap_SL_SR | Speaker kiri samping | Speaker kanan samping |
| ePcxChanMap_Unknown | Tidak dikenal | Tidak dikenal |
Di Windows 7, enumerasi EChannelMapping tidak digunakan lagi. Jenis data anggota ini adalah DWORD. Anggota ini menyimpan kombinasi 0 atau bitwise-OR dari satu atau beberapa nilai berikut yang ditentukan dalam 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
Warna jack. Warna ini dinyatakan sebagai nilai RGB 32-bit yang terbentuk dengan menggabungkan komponen warna biru, hijau, dan merah 8-bit. Komponen biru menempati 8 bit paling tidak signifikan (bit 0-7), komponen hijau menempati bit 8-15, dan komponen merah menempati bit 16-23. 8 bit yang paling signifikan adalah nol. Jika warna jack tidak diketahui atau konektor fisik tidak memiliki warna yang dapat diidentifikasi, nilai anggota ini 0x00000000, yang berwarna hitam.
ConnectionType
Jenis koneksi. Nilai anggota ini adalah salah satu nilai enumerasi EPcxConnectionType yang diperlihatkan dalam tabel berikut ini.
| Nilai | Jenis konektor |
|---|---|
| eConnTypeUnknown | Tidak dikenal |
|
eConnTypeEighth (Windows Vista) eConnType3Point5mm (Windows 7) |
Jack 1/8-inci |
| eConnTypeQuarter | Jack 1/4 inci |
| eConnTypeAtapiInternal | Konektor internal ATAPI |
| eConnTypeRCA | Jack RCA |
| eConnTypeOptical | Konektor optik |
| eConnTypeOtherDigital | Konektor digital generik |
| eConnTypeOtherAnalog | Konektor analog generik |
| eConnTypeMultichannelAnalogDIN | Konektor DIN analog multisaluran |
| eConnTypeXlrProfessional | Konektor XLR |
| eConnTypeRJ11Modem | Konektor modem RJ11 |
| eConnTypeCombination | Kombinasi jenis konektor |
GeoLocation
Lokasi geometris jack. Nilai anggota ini adalah salah satu nilai enumerasi EPcxGeoLocation yang diperlihatkan dalam tabel berikut ini.
| Nilai | Lokasi geometris |
|---|---|
| eGeoLocRear | Panel terpasang belakang |
| eGeoLocFront | Panel yang dipasang di depan |
| eGeoLocLeft | Panel terpasang kiri |
| eGeoLocRight | Panel terpasang kanan |
| eGeoLocTop | Panel terpasang atas |
| eGeoLocBottom | Panel terpasang bawah |
|
eGeoLocRearOPanel(Windows Vista) eGeoLocRearPanel(Windows 7) |
Slide belakang terbuka atau panel tarik-buka |
| eGeoLocRiser | Kartu Riser |
| eGeoLocInsideMobileLid | Tutup dalam komputer seluler |
| eGeoLocDrivebay | Ruang drive |
| eGeoLocHDMI | Konektor HDMI |
| eGeoLocOutsideMobileLid | Tutup luar komputer seluler |
| eGeoLocATAPI | Konektor ATAPI |
GenLocation
Lokasi umum jack. Nilai anggota ini adalah salah satu nilai enumerasi EPcxGenLocation yang diperlihatkan dalam tabel berikut ini.
| Nilai | Lokasi umum |
|---|---|
| eGenLocPrimaryBox | Pada sasis primer |
| eGenLocInternal | Di dalam sasis primer |
|
eGenLocSeperate(Windows Vista) eGenLocSeparate(Windows 7) |
Pada sasis terpisah |
| eGenLocOther | Lokasi lainnya |
PortConnection
Jenis port yang diwakili oleh jack. Nilai anggota ini adalah salah satu nilai enumerasi EPxcPortConnection yang diperlihatkan dalam tabel berikut ini.
| Nilai | Jenis koneksi port |
|---|---|
| ePortConnJack | Jack |
| ePortConnIntegratedDevice | Slot untuk perangkat terintegrasi |
| ePortConnBothIntegratedAndJack | Baik jack maupun slot untuk perangkat terintegrasi |
| ePortConnUnknown | Tidak dikenal |
IsConnected
Jika adaptor audio mendukung deteksi jack-presence pada jack, nilai IsConnected menunjukkan apakah perangkat titik akhir dicolokkan ke jack. Jika IsConnectedTRUE, perangkat akan dicolokkan. Jika FALSE, jack kosong. Untuk perangkat yang tidak mendukung deteksi jack-presence, anggota ini selalu TRUE. Untuk informasi selengkapnya tentang deteksi jack-presence, lihat Perangkat Titik Akhir Audio.
Keterangan
Struktur ini digunakan oleh metode IKsJackDescription::GetJackDescription di DeviceTopology API. Ini menjelaskan jack audio yang merupakan bagian dari koneksi antara perangkat titik akhir dan perangkat keras dalam adaptor audio. Ketika pengguna perlu menyambungkan perangkat titik akhir ke jack atau mencolokkannya dari jack, aplikasi audio dapat menggunakan informasi deskriptif dalam struktur untuk membantu pengguna menemukan jack.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2008 [hanya aplikasi desktop] |
| Header | devicetopology.h |