Partager via

AvSetMmThreadCharacteristicsA, fonction (avrt.h)

  • Article

Associe le thread appelant à la tâche spécifiée.

Syntaxe

AVRTAPI HANDLE AvSetMmThreadCharacteristicsA(
  [in]      LPCSTR  TaskName,
  [in, out] LPDWORD TaskIndex
);

Paramètres

[in] TaskName

Nom de la 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 à la 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 égal à 0 lors du premier appel ou n’est pas une valeur reconnue (lors des 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

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

Notes

L’en-tête avrt.h définit AvSetMmThreadCharacteristics 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. La combinaison 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