Fonction AvSetMmMaxThreadCharacteristicsA (avrt.h)

  • Article

Associe le thread appelant aux tâches spécifiées.

Syntaxe

AVRTAPI HANDLE AvSetMmMaxThreadCharacteristicsA(
  [in]      LPCSTR  FirstTask,
  [in]      LPCSTR  SecondTask,
  [in, out] LPDWORD TaskIndex
);

Paramètres

[in] FirstTask

Nom de la première tâche à effectuer. Ce nom doit correspondre au nom de l’une des sous-clés de la clé suivante HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Multimedia\SystemProfile\Tasks.

[in] SecondTask

Nom de la deuxième tâche à effectuer. Ce nom doit correspondre au nom de l’une des sous-clés de la clé suivante HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Multimedia\SystemProfile\Tasks.

[in, out] TaskIndex

Identificateur de tâche unique. La première fois que cette fonction est appelée, cette valeur doit être 0 en entrée. La valeur d’index est retournée en sortie et peut être utilisée comme entrée dans les appels suivants.

Valeur retournée

Si la fonction réussit, elle retourne un handle à la tâche.

Si la fonction échoue, elle retourne 0. Pour récupérer des informations d’erreur étendues, appelez GetLastError.

Voici les codes d’erreur possibles.

Code de retour Description
ERROR_INVALID_TASK_INDEX
 TaskIndex n’est pas 0 sur le premier appel ou n’est pas une valeur reconnue (sur les appels suivants).
ERROR_INVALID_TASK_NAME
 La tâche spécifiée ne correspond à aucune des tâches stockées dans le Registre.
ERROR_PRIVILEGE_NOT_HELD
 L’appelant ne dispose pas de privilèges suffisants.

Remarques

Les caractéristiques résultantes du thread effectuant les tâches reflètent la tâche ayant la priorité la plus élevée.

Une fois la tâche terminée, appelez la fonction AvRevertMmThreadCharacteristics .

Notes

L’en-tête avrt.h définit AvSetMmMaxThreadCharacteristics comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

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]
Plateforme cible Windows
En-tête avrt.h
Bibliothèque Avrt.lib
DLL Avrt.dll

Voir aussi

Service Planificateur de classes multimédia