midiOutGetErrorTextW (mmeapi.h)

2024-11-20

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

Sintaksis

MMRESULT midiOutGetErrorTextW(
  MMRESULT mmrError,
  LPWSTR   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.

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 MMSYSERR_NOERROR. Semua deskripsi kesalahan kurang dari karakter MAXERRORLENGTH.

Nota

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