Identificateurs de file d’attente de travail

  • Article

Les constantes suivantes identifient les files d’attente de travail Media Foundation standard.

Les applications doivent utiliser MFASYNC_CALLBACK_QUEUE_MULTITHREADED ou utiliser une file d’attente de travail obtenue à partir de MFLockSharedWorkQueue si elles veulent contrôler la priorité d’exécution. Notez que les priorités de file d’attente de travail de la plateforme par défaut peuvent changer dynamiquement lorsqu’une application appelle RegisterPlatformWithMMCSS. Pour plus d’informations sur les files d’attente de travail, consultez Files d’attente de travail.

Constante/valeur Description
MFASYNC_CALLBACK_QUEUE_STANDARD
0x00000001
 Dans la plupart des cas, les applications doivent utiliser MFASYNC_CALLBACK_QUEUE_MULTITHREADED.
Cette file d’attente de travail est utilisée pour les opérations synchrones. L’utilisation de la file d’attente de travail standard peut entraîner un risque d’interblocage. Les applications peuvent créer une file d’attente synchrone privée au-dessus de la file d’attente multithread à l’aide de MFAllocateSerialWorkQueue.
MFASYNC_CALLBACK_QUEUE_RT
0x00000002
 Non pour une utilisation générale de l’application.
MFASYNC_CALLBACK_QUEUE_IO
0x00000003
 Non pour une utilisation générale de l’application.
Cette file d’attente de travail est utilisée en interne pour les opérations d’E/S telles que la lecture de fichiers et la lecture à partir du réseau.
MFASYNC_CALLBACK_QUEUE_TIMER
0x00000004
 Non pour une utilisation générale de l’application.
Cette file d’attente de travail est utilisée pour les rappels périodiques et les éléments de travail planifiés. Les fonctions suivantes placent les éléments de travail dans cette file d’attente :
MFASYNC_CALLBACK_QUEUE_MULTITHREADED
0x00000005
 Cette file d’attente de travail multithread doit être utilisée dans la plupart des cas.
Cette file d’attente de travail est utilisée pour les opérations asynchrones dans Media Foundation.
MFASYNC_CALLBACK_QUEUE_LONG_FUNCTION
0x00000007
 Non pour une utilisation générale de l’application. Les applications doivent plutôt utiliser MFASYNC_CALLBACK_QUEUE_MULTITHREADED.

En outre, les constantes suivantes sont utilisées en relation avec les files d’attente de travail.

Constante/valeur Description
MFASYNC_CALLBACK_QUEUE_UNDEFINED
0x00000000
 File d’attente de travail non définie.
MFASYNC_CALLBACK_QUEUE_PRIVATE_MASK
0xFFFF0000
 Masque de bits pour distinguer les files d’attente de travail de plateforme de celles créées en appelant MFAllocateWorkQueue.
Pour une file d’attente de travail créée par MFAllocateWorkQueue, la valeur suivante est différente de zéro :
(identifier & MFASYNC_CALLBACK_QUEUE_PRIVATE_MASK)
MFASYNC_CALLBACK_QUEUE_ALL
0xFFFFFFFF
 Toutes les files d’attente de travail de la plateforme.

Spécifications

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]
En-tête
Mfobjects.h (include Mfidl.h)

Voir aussi

Constantes Media Foundation

Files d’attente de travail

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