Utilisation du paramètre Context
[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 le lecteur source et l’enregistreurré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.]
Certains des rappels utilisés par le Kit de développement logiciel (SDK) au format Windows Media utilisent un paramètre appelé pvContext. Les objets appelants passent la valeur que vous spécifiez dans la méthode qui a commencé l’action asynchrone. Par exemple, lorsque vous appelez IWMReader::Open, vous pouvez passer une valeur pour pvContext. Lorsque la méthode IWMStatusCallback::OnStatus est appelée par l’objet reader pour informer votre application que le fichier a été ouvert, elle transmet la valeur que vous avez utilisée dans votre appel à Open en tant que paramètre pvContext de OnStatus. Ce paramètre de contexte est fourni pour votre utilisation et vous pouvez l’utiliser comme vous le souhaitez.
Le paramètre pvContext est le plus souvent utilisé lorsque plusieurs objets doivent partager le même rappel. Par exemple, plusieurs objets utilisent la méthode IWMStatusCallback::OnStatus . Vous pouvez utiliser pvContext pour permettre aux différents objets de partager une implémentation d’OnStatus en transmettant une valeur différente pour pvContext sur votre appel d’origine. Dans votre implémentation d’OnStatus, vous pouvez brancher la logique de gestion des messages en fonction de la valeur de pvContext.
Rubriques connexes