Méthode IMFWorkQueueServices ::BeginRegisterTopologyWorkQueuesWithMMCSS (mfidl.h)

Inscrit les files d’attente de travail de topologie auprès du service Planificateur de classes multimédia (MMCSS).

Syntaxe

HRESULT BeginRegisterTopologyWorkQueuesWithMMCSS(
  [in] IMFAsyncCallback *pCallback,
  [in] IUnknown         *pState
);

Paramètres

[in] pCallback

Pointeur vers l’interface IMFAsyncCallback d’un objet de rappel. L’appelant doit implémenter cette interface.

[in] pState

Pointeur vers l’interface IUnknown d’un objet d’état défini par l’appelant. Ce paramètre peut être NULL. Vous pouvez utiliser cet objet pour stocker des informations d’état. L’objet est retourné à l’appelant lorsque le rappel est appelé.

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Chaque nœud source de la topologie définit une branche de la topologie. La branche inclut chaque nœud de topologie qui reçoit des données de ce nœud. Une application peut affecter à chaque branche d’une topologie sa propre file d’attente de travail, puis associer ces files d’attente de travail à des tâches MMCSS.

Pour utiliser cette méthode, procédez comme suit.

1. Créez la topologie.
2. Définissez les attributs suivants sur les nœuds sources dans la topologie.
   • MF_TOPONODE_WORKQUEUE_ID. Spécifie un identificateur pour la file d’attente de travail. La session multimédia alloue une nouvelle file d’attente de travail.
   • MF_TOPONODE_WORKQUEUE_MMCSS_CLASS. Spécifie la classe MMCSS.
   • MF_TOPONODE_WORKQUEUE_MMCSS_TASKID. Spécifie l’identificateur de tâche MMCSS (facultatif). Si cet attribut n’est pas défini, MMCSS affecte un nouvel identificateur de tâche.
3. Mettez la topologie en file d’attente en appelant IMFMediaSession ::SetTopology.
4. Attendez l’événement MESessionTopologyStatus avec le status MF_TOPOSTATUS_READY.
5. Appelez BeginRegisterTopologyWorkQueuesWithMMCSS. Cette méthode enregistre toutes les files d’attente de travail de topologie avec MMCSS.

La méthode BeginRegisterTopologyWorkQueuesWithMMCSS est asynchrone. Une fois l’opération terminée, la méthode IMFAsyncCallback ::Invoke de l’objet de rappel est appelée. Dans la méthode de rappel, appelez IMFWorkQueueServices ::EndRegisterTopologyWorkQueuesWithMMCSS pour terminer la requête asynchrone. Une fois cette opération terminée, la session multimédia enregistre automatiquement les files d’attente de travail pour chaque nouvelle topologie mise en file d’attente sur la session multimédia. L’application n’a pas besoin d’appeler à nouveau la méthode pour de nouvelles topologies.

Pour annuler l’inscription des files d’attente de travail de topologie à partir de MMCSS, appelez IMFWorkQueueServices ::BeginUnregisterTopologyWorkQueuesWithMMCSS.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	mfidl.h
Bibliothèque	Mfuuid.lib

Voir aussi

IMFWorkQueueServices