IWMPError.Item (VB et C#)

[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 propriété Item (méthode get_Item en C#) obtient une interface IWMPErrorItem à l’index spécifié dans la file d’attente d’erreurs.

[Visual Basic]
ReadOnly Property Item(
  dwIndex As System.Integer
) As IWMPErrorItem

[C#]
IWMPErrorItem get_Item (
  System.Int32 dwIndex
);

Paramètres

dwIndex

System.Int32 qui est l’index de base zéro d’une interface IWMPErrorItem dans la file d’attente d’erreurs.

Valeur de propriété

Interface WMPLib.IWMPErrorItem .

Notes

Lecteur multimédia Windows pouvez générer un certain nombre d’erreurs en réponse à une condition d’erreur. Cette propriété obtient une erreur spécifique dans la file d’attente à l’aide d’un numéro d’index. Les numéros d’index de la file d’attente d’erreurs commencent par zéro.

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

Exemples

L’exemple suivant utilise la propriété Item (méthode get_Item en C#) dans un gestionnaire d’événements Error pour récupérer et afficher des informations sur l’erreur la plus récente dans la file d’attente d’erreurs. L’objet AxWMPLib.AxWindowsMediaPlayer est représenté par la variable nommée player.

private void player_ErrorEvent_get_Item(object sender, System.EventArgs e)
{
    // Store the index of the most recent error.
    int max = (player.Error.errorCount - 1);

    // Get an interface for the most recent error item. Cast it to
    // a WMPLib.IWMPErrorItem2 interface to get all of the available functionality.
    WMPLib.IWMPErrorItem2 errItem = (WMPLib.IWMPErrorItem2)player.Error.get_Item(max);

    // Use the interface to access and store the error info.
    int errNum = errItem.errorCode;
    string errDesc = errItem.errorDescription;

    // Display the error info.
    System.Windows.Forms.MessageBox.Show(errNum.ToString() + ":  " + errDesc);
}

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

    ' Store the index of the most recent error.
    Dim max As Integer = (player.Error.errorCount - 1)

    ' Get an interface for the most recent error item. 
    Dim errItem As WMPLib.IWMPErrorItem2 = player.Error.Item(max)

    ' Use the interface to access and store the error info.
    Dim errNum As Integer = errItem.errorCode
    Dim errDesc As String = errItem.errorDescription

    ' Display the error info.
    System.Windows.Forms.MessageBox.Show(errNum.ToString() + ":  " + errDesc)

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#)

Interface IWMPErrorItem (VB et C#)

IWMPSettings.enableErrorDialogs (VB et C#)