AvSetMmThreadCharacteristicsA, fonction (avrt.h)

Article
11/20/2024

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 lors de l’entrée. La valeur d’index est retournée en sortie et peut être utilisée comme entrée dans les appels suivants.

Valeur de retour

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.

Retourner le code	Description
ERROR_INVALID_TASK_INDEX	TaskIndex n’est pas 0 sur le 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 n’a pas de privilège suffisant.

Remarques

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

Note

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

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2008 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	avrt.h
bibliothèque	Avrt.lib
DLL	Avrt.dll

Voir aussi

service planificateur de classes multimédias

Partager via