Interface IMFRealTimeClient (mfidl.h)

  • Article

Avertit un objet pipeline de s’inscrire auprès du service de planificateur de classes multimédia (MMCSS).

Tout objet de pipeline qui crée des threads de travail doit implémenter cette interface.

Héritage

L’interface IMFRealTimeClient hérite de l’interface IUnknown. IMFRealTimeClient a également les types de membres suivants :

Méthodes

L’interface IMFRealTimeClient comporte ces méthodes.

 
IMFRealTimeClient::RegisterThreads

Avertit l’objet d’inscrire ses threads de travail auprès du service MMCSS (Multimedia Class Scheduler Service). (IMFRealTimeClient.RegisterThreads)
IMFRealTimeClient::SetWorkQueue

Spécifie la file d’attente de travail pour la branche de topologie qui contient cet objet.
IMFRealTimeClient::UnregisterThreads

Avertit l’objet de désinscrire ses threads worker du service MMCSS (Multimedia Class Scheduler Service). (IMFRealTimeClient.UnregisterThreads)

Notes

Media Foundation fournit un mécanisme permettant aux applications d’associer des branches de la topologie à des tâches MMCSS. Une branche de topologie est définie par un nœud source dans la topologie et tous les nœuds en aval de celle-ci. Une application inscrit une branche de topologie auprès de MMCSS en définissant l’attribut MF_TOPONODE_WORKQUEUE_ID sur le nœud source, puis en appelant IMFWorkQueueServices::BeginRegisterTopologyWorkQueuesWithMMCSS.

Lorsque l’application inscrit une branche de topologie avec MMCSS, media session interroge chaque objet de pipeline de cette branche pour l’interface IMFRealTimeClient . Si l’objet expose l’interface, la session multimédia appelle RegisterThreads.

Lorsque l’application annule l’inscription de la branche de topologie, la session multimédia appelle UnregisterThreads.

Si un objet pipeline crée ses propres threads de travail mais n’implémente pas cette interface, il peut provoquer des inversions de priorité dans le pipeline Media Foundation, car les threads de traitement à haute priorité peuvent être bloqués en attendant que le composant traite des données sur un thread avec une priorité inférieure.

Les objets de pipeline qui ne créent pas de threads de travail n’ont pas besoin d’implémenter cette interface.

Dans Windows 8, cette interface est étendue avec IMFRealTimeClientEx.

Configuration requise

   
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

Voir aussi

Interfaces Media Foundation