Méthode IWMPError::clearErrorQueue

[La fonctionnalité associée à cette page, Lecteur multimédia Windows SDK, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer. MediaPlayer a été optimisé pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer au lieu de Lecteur multimédia Windows SDK, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La méthode clearErrorQueue efface les erreurs de la file d’attente d’erreurs.

Syntaxe

public void clearErrorQueue();

Public Sub clearErrorQueue()
Implements IWMPError.clearErrorQueue

Paramètres

Cette méthode n’a aucun paramètre.

Valeur retournée

Cette méthode ne retourne pas de valeur.

Notes

Utilisez cette méthode pour effacer la file d’attente d’erreurs après le traitement d’une série d’erreurs.

Vous devez définir IWMPSettings.enableErrorDialogs sur false si vous choisissez d’afficher des messages d’erreur personnalisés.

Exemples

L’exemple suivant utilise clearErrorQueue dans un gestionnaire d’événements Error pour vider la file d’attente d’erreurs une fois que toutes les descriptions d’erreur ont été affichées. L’objet AxWMPLib.AxWindowsMediaPlayer est représenté par la variable nommée player.

private void player_ErrorEvent_clearErrorQueue(object sender, System.EventArgs e)
{
    // Store the number of errors in the queue.
    int max = player.Error.errorCount;

    // Loop through the list of errors.
    for (int i = 0; i < max; i++)
    {
        // Get the description for this error.
        string errDesc = player.Error.get_Item(i).errorDescription;

        // Display the error message.
        System.Windows.Forms.MessageBox.Show(errDesc);
    }

    // Clear the error queue to prepare for the next group of errors.
    player.Error.clearErrorQueue();
}

Public Sub player_ErrorEvent_clearErrorQueue(ByVal sender As Object, ByVal e As System.EventArgs) Handles player.ErrorEvent

    ' Store the number of errors in the queue.
    Dim max As Integer = player.Error.errorCount

    ' Loop through the list of errors.
    For i As Integer = 0 To (max - 1)

        ' Get the description for this error.
        Dim errDesc As String = player.Error.Item(i).errorDescription

        ' Display the error message.
        System.Windows.Forms.MessageBox.Show(errDesc)

    Next i

    ' Clear the error queue to prepare for the next group of errors.
    player.Error.clearErrorQueue()

End Sub

Configuration requise

Condition requise	Valeur
Version	Lecteur multimédia Windows série 9 ou ultérieure
Espace de noms	WMPLib
Assembly	Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

Voir aussi

Interface IWMPError (VB et C#)

IWMPSettings.enableErrorDialogs (VB et C#)