struktur KSJACK_DESCRIPTION (devicetopology.h)

  • Artikel

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
 

Untuk konektor fisik dengan satu, tiga, atau lebih saluran, nilai anggota ini ePcxChanMap_Unknown.

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

Lihat juga

Struktur Audio Inti

IKsJackDescription::GetJackDescription