fungsi waveOutGetDevCaps (mmeapi.h)

Fungsi waveOutGetDevCaps mengambil kemampuan perangkat output waveform-audio tertentu.

Syntax

MMRESULT waveOutGetDevCaps(
  UINT          uDeviceID,
  LPWAVEOUTCAPS 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 WAVEOUTCAPS untuk diisi dengan informasi tentang kemampuan perangkat.

cbwoc

Ukuran, dalam byte, dari struktur WAVEOUTCAPS .

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 [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	mmeapi.h (termasuk Windows.h)
Library	Winmm.lib
DLL	Winmm.dll

Lihat juga

Audio Bentuk Gelombang

Fungsi Bentuk Gelombang