struktur KSJACK_DESCRIPTION

Struktur KSJACK_DESCRIPTION menentukan atribut fisik jack audio.

Sintaks

typedef struct {
  DWORD              ChannelMapping;
  DWORD              Color;
  EPcxConnectionType ConnectionType;
  EPcxGeoLocation    GeoLocation;
  EPcxGenLocation    GenLocation;
  EPxcPortConnection PortConnection;
  BOOL               IsConnected;
} KSJACK_DESCRIPTION, *PKSJACK_DESCRIPTION;

Anggota

ChannelMapping
Menentukan pemetaan saluran audio ke posisi pembicara yang sesuai. ChannelMapping adalah bitmask dari bendera KSAUDIO_SPEAKER_XXX (misalnya, SPEAKER_FRONT_LEFT | SPEAKER_FRONT_RIGHT), yang didefinisikan dalam file header Ksmedia.h. ChannelMapping harus bukan nol hanya untuk pin penyajian analog. Untuk mengambil pin atau untuk pin penyajian digital, atur anggota ini ke 0.

Catatan

 Devicetopology.h awalnya mendefinisikan ChannelMapping sebagai enumerasi jenis EChannelMapping. Enumerasi EChannelMapping sejak itu tidak digunakan lagi dan tidak lagi digunakan di Windows Vista dan versi sistem operasi Windows yang lebih baru.

Warna
Menentukan 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 adalah 0x00000000, yang mewakili hitam.

ConnectionType
Menentukan jenis koneksi fisik untuk jack ini. Nilai anggota ini adalah salah satu nilai enumerasi EPcxConnectionType yang diperlihatkan dalam tabel berikut ini.

Nilai	Jenis konektor
eConnTypeUnknown	Tidak dikenal
eConnType3Point5mm	Minijack 3,5 mm
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 konektor

Geolokasi
Lokasi geometris jack. Nilai anggota ini adalah salah satu nilai enumerasi EPcxGeoLocation yang diperlihatkan dalam tabel berikut ini.

Nilai	Lokasi geometris
eGeoLocRear	Belakang
eGeoLocFront	Front
eGeoLocLeft	Left
eGeoLocRight	Hak
eGeoLocTop	$top
eGeoLocBottom	Bawah
eGeoLocRearPanel	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
eGeoLocNotApplicable	Tidak dapat diterapkan. Lihat bagian Keterangan .

GenLocation
Menentukan 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
eGenLocSeparate	Pada sasis terpisah
eGenLocOther	Lokasi lainnya

PortConnection
Menentukan 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

Terkoneksi
Menunjukkan apakah ada perangkat eksternal yang terhubung ke jack. Jika pengontrol audio mendukung deteksi jack pada pin ini, nilai IsConnected harus secara akurat menunjukkan apakah jack ditempati oleh steker pada waktu tertentu. Nilai ini harus selalu diatur ke TRUE untuk perangkat yang tidak mendukung deteksi jack.

Keterangan

Struktur ini digunakan oleh properti KSPROPERTY_JACK_DESCRIPTION di Windows Vista dan yang lebih baru. 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.

Ketika perangkat audio tidak mengekspos jack yang dapat diakses secara fisik, perangkat audio menggunakan nilai eGeoLocNotApplicable untuk menunjukkan ke aplikasi berbasis Windows dan Windows bahwa tidak ada jack fisik. Dengan demikian, tidak ada lokasi geometris juga. Misalnya, perangkat audio dapat diintegrasikan ke dalam motherboard, tanpa jack yang dapat diakses.

Persyaratan

Header

Ksmedia.h (termasuk Ksmedia.h)

Lihat juga

KSPROPERTY_JACK_DESCRIPTION

KSPROPERTY_JACK_DESCRIPTION2

KSPROPERTY_JACK_DESCRIPTION3