MFBeginRegisterWorkQueueWithMMCSSEx, fonction (mfapi.h)

Associe une file d’attente de travail à une tâche MMCSS (Multimedia Class Scheduler Service).

Syntaxe

HRESULT MFBeginRegisterWorkQueueWithMMCSSEx(
  [in] DWORD            dwWorkQueueId,
  [in] LPCWSTR          wszClass,
  [in] DWORD            dwTaskId,
  [in] LONG             lPriority,
  [in] IMFAsyncCallback *pDoneCallback,
  [in] IUnknown         *pDoneState
);

Paramètres

[in] dwWorkQueueId

Identificateur de la file d’attente de travail. Pour les files d’attente de travail privées, l’identificateur est retourné par la fonction MFAllocateWorkQueue . Pour connaître les files d’attente de travail de plateforme, consultez Identificateurs de file d’attente de travail.

[in] wszClass

Nom de la tâche MMCSS. Pour plus d’informations, consultez le service Planificateur de classes multimédias.

[in] dwTaskId

Identificateur de tâche unique. Pour obtenir un nouvel identificateur de tâche, définissez cette valeur sur zéro.

[in] lPriority

Priorité relative de base pour les threads de file d’attente de travail. Pour plus d’informations, consultez AvSetMmThreadPriority.

[in] pDoneCallback

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

[in] pDoneState

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 contenir des informations d’état. L’objet est retourné à l’appelant lorsque le rappel est appelé.

Valeur retournée

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

Remarques

Cette fonction étend la fonction MFBeginRegisterWorkQueueWithMMCSS en ajoutant le paramètre lPriority .

Cette fonction est asynchrone. Une fois l’opération terminée, la méthode IMFAsyncCallback ::Invoke de l’objet de rappel est appelée. À ce stade, appelez MFEndRegisterWorkQueueWithMMCSS pour terminer la requête asynchrone.

Pour annuler l’inscription de la file d’attente de travail à partir de la tâche MMCSS, appelez MFBeginUnregisterWorkQueueWithMMCSS.

Spécifications

Voir aussi

Fonctions Media Foundation

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

Files d’attente de travail