midiInGetErrorTextA (mmeapi.h)

Artikel
20/11/2024

Fungsi midiInGetErrorText mengambil deskripsi tekstual untuk kesalahan yang diidentifikasi oleh kode kesalahan yang ditentukan.

Sintaksis

MMRESULT midiInGetErrorTextA(
  MMRESULT mmrError,
  LPSTR    pszText,
  UINT     cchText
);

Parameter

mmrError

Kode kesalahan.

pszText

Penunjuk ke buffer untuk diisi dengan deskripsi kesalahan tekstual.

cchText

Panjang, dalam karakter, dari buffer yang ditujukkan oleh lpText.

Mengembalikan nilai

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

Mengembalikan kode	Deskripsi
MMSYSERR_BADERRNUM	Nomor kesalahan yang ditentukan berada di luar rentang.
MMSYSERR_INVALPARAM	Penunjuk atau struktur yang ditentukan tidak valid.
MMSYSERR_NOMEM	Sistem tidak dapat mengalokasikan atau mengunci memori.

Komentar

Jika deskripsi kesalahan tekstual lebih panjang dari buffer yang ditentukan, deskripsi akan dipotong. String kesalahan yang dikembalikan selalu dihentikan null. Jika cchText adalah nol, tidak ada yang disalin, dan fungsi mengembalikan nol. Semua deskripsi kesalahan kurang dari karakter MAXERRORLENGTH.

Catatan

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

Bagikan melalui