fungsi midiInGetDevCapsA (mmeapi.h)

Artikel
11/20/2024

Fungsi midiInGetDevCaps menentukan kemampuan perangkat input MIDI tertentu.

Sintaksis

MMRESULT midiInGetDevCapsA(
  UINT_PTR      uDeviceID,
  LPMIDIINCAPSA pmic,
  UINT          cbmic
);

Parameter

uDeviceID

Pengidentifikasi perangkat input MIDI. Pengidentifikasi perangkat bervariasi dari nol hingga satu kurang dari jumlah perangkat yang ada. Parameter ini juga dapat menjadi handel perangkat yang dilemparkan dengan benar.

pmic

Arahkan ke struktur MIDIINCAPS yang diisi dengan informasi tentang kemampuan perangkat.

cbmic

Ukuran, dalam byte, dari struktur MIDIINCAPS . Hanya cbMidiInCaps byte (atau kurang) informasi yang disalin ke lokasi yang ditujukkan oleh lpMidiInCaps. Jika cbMidiInCaps nol, tidak ada yang disalin, dan fungsi mengembalikan MMSYSERR_NOERROR.

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_INVALPARAM	Penunjuk atau struktur yang ditentukan tidak valid.
MMSYSERR_NODRIVER	Pengandar tidak terinstal.
MMSYSERR_NOMEM	Sistem tidak dapat mengalokasikan atau mengunci memori.

Komentar

Untuk menentukan jumlah perangkat input MIDI yang ada pada sistem, gunakan fungsi midiInGetNumDevs .

Nota

Header mmeapi.h mendefinisikan midiInGetDevCaps 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

Fungsi MIDI

Bagikan melalui