Zpracování chyb MCI

[Funkce přidružená k této stránce, MCI, je starší funkce. Bylo nahrazeno MediaPlayer. MediaPlayer je optimalizovaný pro Windows 10 a Windows 11. Microsoft důrazně doporučuje, aby nový kód používal MediaPlayer místo MCI, pokud je to možné. Microsoft navrhuje, aby se stávající kód, který používá starší rozhraní API, přepsal, aby se nová rozhraní API používala, pokud je to možné.]

Vždy byste měli zkontrolovat návratovou hodnotu funkce mciSendCommand. Pokud značí chybu, můžete k získání textového popisu chyby použít mciGetErrorString.

Následující příklad předá kód chyby MCI určený pomocí dwError do mciGetErrorString, a poté zobrazí výsledný textový popis chyby pomocí funkce 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);
    }
}
 

Poznámka

Pokud chcete interpretovat chybovou hodnotu mciSendCommand, zamaskujte vyšší řád slova (slovo s nižším řádem obsahuje kód chyby). Pokud předáte vrácenou hodnotu chyby mciGetErrorString, musíte však předat celou hodnotu dvojslova.