Gestion des erreurs (SDK Lecteur multimédia Windows)

  • Article

[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.]

Le contrôle ActiveX Lecteur multimédia Windows 6.4 assure la gestion des erreurs par défaut en affichant les messages d’erreur dans les boîtes de dialogue et dans la barre de status. Vous pouvez également fournir une gestion personnalisée des erreurs en traitant les erreurs dans votre script. La gestion des erreurs est pilotée par les événements, ce qui signifie que vous recevez une notification pour chaque erreur et que vous devez décider comment traiter chaque événement d’erreur lorsqu’il se produit. Pour plus d’informations sur la gestion des erreurs à l’aide du modèle objet version 6.4, consultez la section Gestion des erreurs du Guide du modèle objet du lecteur version 6.4, qui fait partie du Kit de développement logiciel (SDK) Lecteur multimédia Windows.

Le modèle objet Lecteur multimédia Windows 7 ou version ultérieure fournit l’objet Error et l’objet ErrorItem pour gérer les erreurs. Ces deux objets fonctionnent ensemble pour vous fournir un mécanisme de gestion des erreurs qui vous donne un contrôle complet et flexible du processus de gestion des erreurs. L’objet Error fournit l’accès à une collection d’objets ErrorItem ; chaque objet ErrorItem fournit des détails sur un message d’erreur individuel.

Lorsqu’une erreur se produit, les informations d’erreur sont publiées dans une file d’attente d’erreurs. La file d’attente est une collection d’objets ErrorItem . Chaque erreur étant ajoutée à la file d’attente, elle est associée à un numéro d’index (commençant par zéro) qui peut être utilisé pour identifier l’objet ErrorItem particulier. Erreur. la propriété errorCount récupère le nombre d’erreurs dans la file d’attente d’erreurs. Étant donné que les numéros d’index sont de base zéro, l’erreur la plus récente publiée dans la file d’attente aura toujours une valeur d’index égale à Erreur. errorCount moins un.

Vous pouvez créer un gestionnaire d’événements d’erreur pour Lecteur multimédia Windows à l’aide d’un script. L’exemple JScript suivant montre comment récupérer l’élément d’erreur le plus récent de la file d’attente d’erreurs et afficher le code d’erreur et la description de l’erreur à l’aide du modèle objet Lecteur multimédia Windows 7 ou version ultérieure. L’objet Player a été créé avec ID = « WMP9 ».

<!-- Create an error event handler for Windows Media Player 7 or later errors. -->
<SCRIPT  LANGUAGE = "JScript"  FOR = WMP9  EVENT = error()>

// Store the number of errors in the error queue.
var max = WMP9.error.errorCount;

// Retrieve most recent ErrorItem object.
var err = WMP9.error.item(max-1)

// Store the error code number.
var errNum = err.errorCode;

// Store the error description string.
var errDesc = err.errorDescription;

// Build a message string to notify the user.
var msg = "Error number: " + errNum + "\n";
msg += "Error description: " + errDesc;

// Display the message box.
alert(msg);

</SCRIPT>

L’objet Error a deux méthodes supplémentaires que vous pouvez utiliser. Erreur. La méthode clearErrorQueue vous permet de supprimer toutes les erreurs de la file d’attente d’erreurs et de réinitialiser le numéro d’index à zéro. Vous avez un contrôle total sur ce processus ; vous pouvez conserver les erreurs dans la file d’attente aussi longtemps que vous en avez besoin, puis vider la file d’attente lorsque vous avez terminé de gérer les erreurs.

Erreur. La méthode webHelp permet d’afficher les informations d’erreur les plus actuelles à l’utilisateur à l’aide d’Internet. Lorsqu’elle est appelée, cette méthode transfère toutes les informations pertinentes sur la première erreur dans la file d’attente (celle avec index zéro) à Microsoft Lecteur multimédia Windows Web Help, qui affiche des informations supplémentaires sur l’erreur dans la fenêtre actuelle du navigateur.

Error, objet

Objet ErrorItem

Guide de migration du modèle objet