Struktur WAVEOUTCAPSW (mmeapi.h)

Artikel
11/20/2024

Struktur WAVEOUTCAPS menjelaskan kemampuan perangkat output waveform-audio.

Sintaksis

typedef struct tagWAVEOUTCAPSW {
  WORD      wMid;
  WORD      wPid;
  MMVERSION vDriverVersion;
  WCHAR     szPname[MAXPNAMELEN];
  DWORD     dwFormats;
  WORD      wChannels;
  WORD      wReserved1;
  DWORD     dwSupport;
} WAVEOUTCAPSW, *PWAVEOUTCAPSW, *NPWAVEOUTCAPSW, *LPWAVEOUTCAPSW;

Anggota

wMid

Pengidentifikasi produsen untuk pengandar perangkat untuk perangkat. Pengidentifikasi produsen didefinisikan dalam Produsen dan Pengidentifikasi Produk.

wPid

Pengidentifikasi produk untuk perangkat. Pengidentifikasi produk didefinisikan dalam Produsen dan Pengidentifikasi Produk.

vDriverVersion

Nomor versi driver perangkat untuk perangkat. Byte urutan tinggi adalah nomor versi utama, dan byte urutan rendah adalah nomor versi minor.

szPname[MAXPNAMELEN]

Nama produk dalam string yang dihentikan null.

dwFormats

Format standar yang didukung. Dapat berupa kombinasi dari yang berikut ini:

Format	Deskripsi
WAVE_FORMAT_1M08	11,025 kHz, mono, 8-bit
WAVE_FORMAT_1M16	11,025 kHz, mono, 16-bit
WAVE_FORMAT_1S08	11,025 kHz, stereo, 8-bit
WAVE_FORMAT_1S16	11,025 kHz, stereo, 16-bit
WAVE_FORMAT_2M08	22,05 kHz, mono, 8-bit
WAVE_FORMAT_2M16	22,05 kHz, mono, 16-bit
WAVE_FORMAT_2S08	22,05 kHz, stereo, 8-bit
WAVE_FORMAT_2S16	22,05 kHz, stereo, 16-bit
WAVE_FORMAT_4M08	44,1 kHz, mono, 8-bit
WAVE_FORMAT_4M16	44,1 kHz, mono, 16-bit
WAVE_FORMAT_4S08	44,1 kHz, stereo, 8-bit
WAVE_FORMAT_4S16	44,1 kHz, stereo, 16-bit
WAVE_FORMAT_96M08	96 kHz, mono, 8-bit
WAVE_FORMAT_96M16	96 kHz, mono, 16-bit
WAVE_FORMAT_96S08	96 kHz, stereo, 8-bit
WAVE_FORMAT_96S16	96 kHz, stereo, 16-bit

wChannels

Angka yang menentukan apakah perangkat mendukung output mono (1) atau stereo (2).

wReserved1

dwSupport

Fungsionalitas opsional yang didukung oleh perangkat. Nilai berikut didefinisikan:

Bendera	Deskripsi
WAVECAPS_LRVOLUME	Mendukung kontrol volume kiri dan kanan terpisah.
WAVECAPS_PITCH	Mendukung kontrol pitch.
WAVECAPS_PLAYBACKRATE	Mendukung kontrol laju pemutaran.
WAVECAPS_SYNC	Driver sinkron dan akan memblokir saat memainkan buffer.
WAVECAPS_VOLUME	Mendukung kontrol volume.
WAVECAPS_SAMPLEACCURATE	Mengembalikan informasi posisi yang akurat sampel.

Komentar

Jika perangkat mendukung perubahan volume, bendera WAVECAPS_VOLUME akan diatur untuk anggota dwSupport. Jika perangkat mendukung perubahan volume terpisah di saluran kiri dan kanan, bendera WAVECAPS_VOLUME dan WAVECAPS_LRVOLUME akan diatur untuk anggota ini.

Nota

Header mmeapi.h mendefinisikan WAVEOUTCAPS sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	mmeapi.h (termasuk Windows.h)

Lihat juga

Audio Waveform

Struktur Bentuk Gelombang

Bagikan melalui