AvSetMmMaxThreadCharacteristicsA, fonction (avrt.h)
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 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 |
|---|---|
|
TaskIndex n’est pas 0 sur le premier appel ou n’est pas une valeur reconnue (lors des appels suivants). |
|
La tâche spécifiée ne correspond à aucune des tâches stockées dans le Registre. |
|
L’appelant n’a pas de privilège suffisant. |
Remarques
Les caractéristiques résultantes du thread effectuant les tâches reflètent la tâche avec la priorité la plus élevée.
Une fois la tâche terminée, appelez la fonction AvRevertMmThreadCharacteristics.
Note
L’en-tête avrt.h définit AvSetMmMaxThreadCharacteristics 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 |