fungsi midiOutGetDevCapsW (mmeapi.h)

Fungsi midiOutGetDevCaps meminta perangkat output MIDI tertentu untuk menentukan kemampuannya.

Sintaksis

MMRESULT midiOutGetDevCapsW(
  UINT_PTR       uDeviceID,
  LPMIDIOUTCAPSW pmoc,
  UINT           cbmoc
);

Parameter

uDeviceID

Pengidentifikasi perangkat output MIDI. Pengidentifikasi perangkat yang ditentukan oleh parameter ini bervariasi dari nol hingga satu kurang dari jumlah perangkat yang ada. Konstanta MIDI_MAPPER juga merupakan pengidentifikasi perangkat yang valid.

Parameter ini juga dapat menjadi handel perangkat yang dilemparkan dengan benar.

pmoc

Penunjuk ke struktur MIDIOUTCAPS . Struktur ini diisi dengan informasi tentang kemampuan perangkat.

cbmoc

Ukuran, dalam byte, dari struktur MIDIOUTCAPS . Hanya cbMidiOutCaps byte (atau kurang) informasi yang disalin ke lokasi yang ditunjukkan oleh lpMidiOutCaps. Jika cbMidiOutCaps adalah 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 memuat deskripsi string pemeta.

Komentar

Untuk menentukan jumlah perangkat output MIDI yang ada dalam sistem, gunakan fungsi midiOutGetNumDevs .

Nota

Header mmeapi.h mendefinisikan midiOutGetDevCaps 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]
Platform Target	Windows
Header	mmeapi.h (termasuk Windows.h)
Pustaka	Winmm.lib
DLL	Winmm.dll

Lihat juga

Fungsi MIDI