AvSetMmThreadCharacteristicsA, fonction (avrt.h)

Article
02/28/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 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

Partager via