Control de errores de MCI

[La característica asociada a esta página, MCI, es una característica heredada. Se ha reemplazado por MediaPlayer. MediaPlayer se ha optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer en lugar de MCI, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

Siempre debe comprobar el valor devuelto de la función mciSendCommand . Si indica un error, puede usar mciGetErrorString para obtener una descripción textual del error.

En el ejemplo siguiente se pasa el código de error de MCI especificado por dwError a mciGetErrorString y, a continuación, se muestra la descripción del error textual resultante mediante la función 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:

Para interpretar un valor devuelto de error mciSendCommand usted mismo, enmascara la palabra de orden superior (la palabra de orden bajo contiene el código de error). Sin embargo, si pasa el valor devuelto del error a mciGetErrorString, debe pasar el valor de doble palabra completo.