fungsi waveOutGetDevCapsA (mmeapi.h)

Fungsi waveOutGetDevCapsA mengambil kemampuan perangkat output waveform-audio tertentu. Ini adalah versi ANSI dari fungsi.

Syntax

MMRESULT waveOutGetDevCapsA(
  UINT_PTR       uDeviceID,
  LPWAVEOUTCAPSA pwoc,
  UINT           cbwoc
);

Parameter-parameternya

uDeviceID

Pengidentifikasi perangkat output waveform-audio. Ini dapat berupa pengidentifikasi perangkat atau handel perangkat output waveform-audio terbuka.

pwoc

Pointer ke struktur WAVEOUTCAPSA untuk diisi dengan informasi tentang kemampuan perangkat.

cbwoc

Ukuran, dalam byte, dari struktur WAVEOUTCAPSA .

Mengembalikan nilai

Mengembalikan MMSYSERR_NOERROR jika berhasil atau kesalahan sebaliknya. Kemungkinan nilai kesalahan termasuk yang berikut ini.

Mengembalikan kode	Description
MMSYSERR_BADDEVICEID	Pengidentifikasi perangkat yang ditentukan berada di luar rentang.
MMSYSERR_NODRIVER	Tidak ada driver perangkat.
MMSYSERR_NOMEM	Tidak dapat mengalokasikan atau mengunci memori.

Komentar

Gunakan fungsi waveOutGetNumDevs untuk menentukan jumlah perangkat output waveform-audio yang ada dalam sistem. Jika nilai yang ditentukan oleh parameter uDeviceID adalah pengidentifikasi perangkat, nilai tersebut dapat bervariasi dari nol hingga satu kurang dari jumlah perangkat yang ada. Konstanta WAVE_MAPPER juga dapat digunakan sebagai pengidentifikasi perangkat. Hanya byte cbwoc (atau kurang) informasi yang disalin ke lokasi yang diarahkan oleh pwoc. Jika cbwoc nol, tidak ada yang disalin dan fungsi mengembalikan nol.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional
Server minimum yang didukung	Windows 2000 Server
Header	mmeapi.h
Library	Winmm.lib
DLL	Winmm.dll

Lihat juga

Audio Bentuk Gelombang

Fungsi Bentuk Gelombang