Обработка ошибок MCI

[Функция, связанная с этой страницей, MCI, является устаревшей функцией. Он был заменён на MediaPlayer . MediaPlayer оптимизирован для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать новый код MediaPlayer вместо MCIпо возможности. Корпорация Майкрософт предлагает, что существующий код, использующий устаревшие API, будет перезаписан для использования новых API, если это возможно.]

Всегда следует проверять возвращаемое значение функции mciSendCommand. Если это указывает на ошибку, можно использовать mciGetErrorString для получения текстового описания ошибки.

В следующем примере код ошибки MCI, указанный dwError, передается функции mciGetErrorString, а затем отображается итоговое текстовое описание ошибки с помощью функции 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);
    }
}
 

Заметка

Чтобы интерпретировать значение ошибки mciSendCommand самостоятельно, маскируйте слово с высоким порядком (слово с низким порядком содержит код ошибки). При передаче значения ошибки в mciGetErrorStringнеобходимо передать полное значение двойного слова.