AvSetMmMaxThreadCharacteristicsA-Funktion (avrt.h)
Ordnet den aufrufenden Thread den angegebenen Vorgängen zu.
Syntax
AVRTAPI HANDLE AvSetMmMaxThreadCharacteristicsA(
[in] LPCSTR FirstTask,
[in] LPCSTR SecondTask,
[in, out] LPDWORD TaskIndex
);
Parameter
[in] FirstTask
Der Name des ersten auszuführenden Vorgangs. Dieser Name muss mit dem Namen eines der Unterschlüssel des folgenden Schlüssels HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Multimedia\SystemProfile\Tasksübereinstimmen.
[in] SecondTask
Der Name des zweiten auszuführenden Vorgangs. Dieser Name muss mit dem Namen eines der Unterschlüssel des folgenden Schlüssels HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Multimedia\SystemProfile\Tasksübereinstimmen.
[in, out] TaskIndex
Der eindeutige Vorgangsbezeichner. Wenn diese Funktion zum ersten Mal aufgerufen wird, muss dieser Wert 0 für die Eingabe sein. Der Indexwert wird für die Ausgabe zurückgegeben und kann in nachfolgenden Aufrufen als Eingabe verwendet werden.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird ein Handle an die Aufgabe zurückgegeben.
Wenn die Funktion fehlschlägt, wird 0 zurückgegeben. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen abzurufen.
Im Folgenden finden Sie mögliche Fehlercodes.
| Rückgabecode | Beschreibung |
|---|---|
|
Entweder TaskIndex- ist für den ersten Aufruf nicht 0 oder wird kein Wert erkannt (bei nachfolgenden Aufrufen). |
|
Die angegebene Aufgabe stimmt nicht mit den vorgängen überein, die in der Registrierung gespeichert sind. |
|
Der Aufrufer verfügt nicht über ausreichende Berechtigungen. |
Bemerkungen
Die resultierenden Merkmale des Threads, der die Aufgaben ausführt, spiegeln die Aufgabe mit der höchsten Priorität wider.
Rufen Sie nach Abschluss der Aufgabe die AvRevertMmThreadCharacteristics-Funktion auf.
Anmerkung
Der avrt.h-Header definiert AvSetMmMaxThreadCharacteristics als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows Server 2008 [Nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | avrt.h |
| Library | Avrt.lib |
| DLL- | Avrt.dll |