Utilisation du rappel OnStatus
[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.]
La méthode de rappel IWMStatusCallback::OnStatus est appelée par plusieurs objets dans le Kit de développement logiciel (SDK) au format Windows Media. OnStatus reçoit des messages qui représentent les modifications apportées à la status des opérations sdk.
Pour utiliser la méthode de rappel OnStatus , vous devez implémenter une classe dans votre application qui hérite de l’interface IWMStatusCallback . Incluez le code de votre version d’OnStatus dans la classe . Vous trouverez plusieurs exemples d’implémentations d’OnStatus dans les exemples inclus dans ce kit SDK. Pour plus d’informations sur les exemples, consultez Exemples d’applications.
Vous devez associer votre implémentation du rappel status à différents objets du Kit de développement logiciel (SDK) au format Windows Media. Chaque objet a une façon différente de faire cette association. Pour obtenir la liste des méthodes qui associent des objets spécifiques, consultez la page de référence IWMStatusCallback .
Les messages status qui peuvent être reçus par OnStatus sont définis dans le type d’énumération WMT_STATUS.
Vous pouvez choisir les messages à intercepter et ceux à ignorer. Toutefois, il est nécessaire de répondre à certains messages status pour certaines fonctionnalités. Par exemple, lors de l’utilisation du lecteur asynchrone, la méthode IWMReader::Open ouvre un fichier de manière asynchrone. La seule façon de savoir quand le fichier a été ouvert consiste à intercepter le message MWT_OPENED. En règle générale, les messages à lesquels vous répondez sont des notifications de l’achèvement de tâches asynchrones.
Rubriques connexes