Pour implémenter des messages de lecteur dans le rappel OnStatus

  • Article

[La fonctionnalité associée à cette page, le Kit de développement logiciel (SDK) Windows Media Format 11, est une fonctionnalité héritée. Il a été remplacé par lecteur source et enregistreur récepteur. Le lecteur source et l’enregistreur récepteur ont été optimisés pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise le lecteur source et l’enregistreur récepteur au lieu du Kit de développement logiciel (SDK) Windows Media Format 11, 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.]

Pour utiliser le lecteur asynchrone afin de fournir du contenu à partir d’un fichier ASF, vous devez implémenter au moins deux méthodes de rappel, IWMStatusCallback::OnStatus et IWMReaderCallback::OnSample. Cette section explique comment implémenter IWMStatusCallback::OnStatus pour recevoir et répondre à status messages envoyés par le lecteur. OnStatus est utilisé par d’autres objets dans le Kit de développement logiciel (SDK) au format Windows Media. Pour plus d’informations générales sur OnStatus, consultez Utilisation du rappel OnStatus.

Lorsque vous utilisez le lecteur asynchrone, vous devez intercepter les messages suivants dans IWMStatusCallback::OnStatus.

Message d’état Description
WMT_OPENED Envoyé lorsque les opérations d’ouverture de fichier sont terminées.
WMT_CLOSED Envoyé lorsque les opérations de fermeture de fichier sont terminées.

 

Vous devez utiliser les messages status répertoriés ci-dessus pour contrôler l’exécution de votre application de lecture. Par exemple, vous devez attendre la réception du message WMT_OPENED pour démarrer le lecteur ou appeler d’autres méthodes qui nécessitent que le lecteur ait un fichier prêt. Souvent, les applications créées avec le lecteur asynchrone utilisent un événement pour signaler l’achèvement des appels asynchrones et poursuivre le traitement. Pour plus d’informations sur l’utilisation d’événements pour signaler l’achèvement des opérations, consultez Utilisation d’événements avec des appels asynchrones.

De nombreux autres messages sont envoyés à OnStatus par l’objet lecteur pour permettre à l’application de répondre aux status des opérations de lecture. Les valeurs de message status possibles sont définies dans le type d’énumération WMT_STATUS.

IWMStatusCallback::OnStatus

Lecture de fichiers avec le lecteur asynchrone

Utilisation du rappel OnStatus