Fonction MFBeginRegisterWorkQueueWithMMCSSEx (mfapi.h)

Article
03/01/2024

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 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 Service Planificateur de classes multimédia.

[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 stocker 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 de la tâche MMCSS, appelez MFBeginUnregisterWorkQueueWithMMCSS.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	mfapi.h
DLL	Mfplat.dll

Voir aussi

Fonctions Media Foundation

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

Files d’attente de travail

Partager via