Menangani Kesalahan MCI

[Fitur yang terkait dengan halaman ini, MCI, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer. MediaPlayer telah dioptimalkan untuk Windows 10 dan Windows 11. Microsoft sangat menyarankan agar kode baru menggunakan MediaPlayer alih-alih MCI, jika memungkinkan. Microsoft menyarankan agar kode yang ada yang menggunakan API warisan ditulis ulang untuk menggunakan API baru jika memungkinkan.]

Anda harus selalu memeriksa nilai pengembalian fungsimciSendCommand. Jika menunjukkan kesalahan, Anda dapat menggunakan mciGetErrorString untuk mendapatkan deskripsi tekstual kesalahan.

Contoh berikut meneruskan kode kesalahan MCI yang ditentukan oleh dwError ke mciGetErrorString, lalu menampilkan deskripsi kesalahan tekstual yang dihasilkan menggunakan fungsi MessageBox.

// Use mciGetErrorString to get a textual description of an MCI error.
// Display the error description using MessageBox.

void showError(DWORD dwError)
{
    char szErrorBuf[MAXERRORLENGTH];
    MessageBeep(MB_ICONEXCLAMATION);
    if(mciGetErrorString(dwError, (LPSTR) szErrorBuf, MAXERRORLENGTH))
    {
        MessageBox(hMainWnd, szErrorBuf, "MCI Error",
        MB_ICONEXCLAMATION);
    }
    else
    {
        MessageBox(hMainWnd, "Unknown Error", "MCI Error",
            MB_ICONEXCLAMATION);
    }
}
 

Nota

Untuk menafsirkan sendiri nilai pengembalian kesalahan mciSendCommand, tutupi kata tinggi (kata rendah berisi kode kesalahan). Jika Anda meneruskan nilai pengembalian kesalahan ke mciGetErrorString, Anda harus meneruskan seluruh nilai doubleword.