fungsi mixerGetDevCapsA (mmeapi.h)

Fungsi mixerGetDevCaps meminta perangkat mixer tertentu untuk menentukan kemampuannya.

Sintaksis

MMRESULT mixerGetDevCapsA(
  UINT_PTR     uMxId,
  LPMIXERCAPSA pmxcaps,
  UINT         cbmxcaps
);

Parameter

uMxId

Pengidentifikasi atau handel perangkat mixer terbuka.

pmxcaps

Pointer ke struktur MIXERCAPS yang menerima informasi tentang kemampuan perangkat.

cbmxcaps

Ukuran, dalam byte, dari struktur MIXERCAPS .

Mengembalikan nilai

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

Mengembalikan kode	Deskripsi
MMSYSERR_BADDEVICEID	Pengidentifikasi perangkat yang ditentukan berada di luar rentang.
MMSYSERR_INVALHANDLE	Handel perangkat mixer tidak valid.
MMSYSERR_INVALPARAM	Satu atau beberapa parameter tidak valid.

Komentar

Gunakan fungsi mixerGetNumDevs untuk menentukan jumlah perangkat mixer yang ada dalam sistem. Pengidentifikasi perangkat yang ditentukan oleh uMxId bervariasi dari nol hingga satu kurang dari jumlah perangkat mixer yang ada.

Hanya jumlah byte (atau kurang) informasi yang ditentukan dalam cbmxcaps disalin ke lokasi yang ditunjukkan oleh pmxcaps. Jika cbmxcaps nol, tidak ada yang disalin, dan fungsi berhasil dikembalikan.

Fungsi ini juga menerima handel perangkat mixer yang dikembalikan oleh fungsi mixerOpen sebagai parameter uMxId . Aplikasi harus mentransmisikan handel HMIXER keUINT .

Catatan

Header mmeapi.h mendefinisikan mixerGetDevCaps sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praproscesor 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]
Platform Target	Windows
Header	mmeapi.h (termasuk Windows.h)
Pustaka	Winmm.lib
DLL	Winmm.dll

Lihat juga

Audio Mixer Functions

Audio Mixer