Share via

struktur ACX_JACK_DESCRIPTION (acxpin.h)

  • Artikel

Struktur ACX_JACK_DESCRIPTION menjelaskan atribut jack audio, seperti jenis koneksi, lokasi fisik, dan sebagainya.

Sintaks

typedef struct _ACX_JACK_DESCRIPTION {
  ULONG                    ChannelMapping;
  ULONG                    Color;
  ACX_JACK_CONNECTION_TYPE ConnectionType;
  ACX_JACK_GEO_LOCATION    GeoLocation;
  ACX_JACK_GEN_LOCATION    GenLocation;
  ACX_JACK_PORT_CONNECTION PortConnection;
} ACX_JACK_DESCRIPTION, *PACX_JACK_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.

Color

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

GeoLocation

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

Keterangan

Struktur 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 ACX

Versi ACX minimum: 1.0

Untuk informasi selengkapnya tentang versi ACX, lihat Gambaran umum versi ACX.

Persyaratan

Persyaratan Nilai
Header acxpin.h

Lihat juga