Méthode IMFRealTimeClientEx ::RegisterThreadsEx (mfidl.h)

  • Article

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

Syntaxe

HRESULT RegisterThreadsEx(
  [in, out] DWORD   *pdwTaskIndex,
  [in]      LPCWSTR wszClassName,
  [in]      LONG    lBasePriority
);

Paramètres

[in, out] pdwTaskIndex

Identificateur de tâche MMCSS. Si la valeur est égale à zéro sur l’entrée, l’objet doit créer un groupe de tâches MCCSS. Consultez la section Notes.

[in] wszClassName

Nom de la tâche MMCSS.

[in] lBasePriority

Priorité de base du thread.

Valeur retournée

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

Remarques

Si l’objet ne crée pas de threads de travail, la méthode doit simplement retourner S_OK et n’effectuer aucune autre action.

Sinon, si la valeur de *pdwTaskIndex est zéro en entrée, l’objet doit effectuer les étapes suivantes :

  1. Un thread de travail unique appelle AvSetMmThreadCharacteristics pour créer un identificateur de tâche MMCSS. Stockez cette valeur.
  2. Tous les threads de travail supplémentaires appellent AvSetMmThreadCharacteristics à l’aide du nouvel identificateur de tâche.
  3. Retournez le nouvel identificateur de tâche à l’appelant, en définissant *pdwTaskIndex comme égal à l’identificateur de tâche.
Si la valeur de est différente de *pdwTaskIndex zéro en entrée, le paramètre contient un identificateur de tâche MMCSS existant. Dans ce cas, tous les threads de travail de l’objet doivent s’inscrire pour cette tâche en appelant AvSetMmThreadCharacteristics.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête mfidl.h

Voir aussi

IMFRealTimeClientEx

Améliorations apportées à la file d’attente de travail et au threading