AvSetMmMaxThreadCharacteristicsA-Funktion (avrt.h)
Ordnet den aufrufenden Thread den angegebenen Aufgaben zu.
Syntax
AVRTAPI HANDLE AvSetMmMaxThreadCharacteristicsA(
[in] LPCSTR FirstTask,
[in] LPCSTR SecondTask,
[in, out] LPDWORD TaskIndex
);
Parameter
[in] FirstTask
Der Name der ersten auszuführenden Aufgabe. 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 der zweiten auszuführenden Aufgabe. 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 Aufgabenbezeichner. Wenn diese Funktion zum ersten Mal aufgerufen wird, muss dieser Wert bei der Eingabe 0 sein. Der Indexwert wird bei der Ausgabe zurückgegeben und kann als Eingabe in nachfolgenden Aufrufen verwendet werden.
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt sie ein Handle an die Aufgabe zurück.
Wenn die Funktion fehlschlägt, gibt sie 0 zurück. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen abzurufen.
Im Folgenden sind mögliche Fehlercodes aufgeführt.
Rückgabecode | Beschreibung |
---|---|
|
Entweder ist TaskIndex beim ersten Aufruf nicht 0 oder wird (bei nachfolgenden Aufrufen) nicht erkannt. |
|
Die angegebene Aufgabe entspricht keinem der in der Registrierung gespeicherten Aufgaben. |
|
Der Aufrufer verfügt nicht über ausreichende Berechtigungen. |
Hinweise
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 Funktion AvRevertMmThreadCharacteristics auf .
Hinweis
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 nicht codierungsneutralem Code 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 |
---|---|
Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | avrt.h |
Bibliothek | Avrt.lib |
DLL | Avrt.dll |