AvSetMmMaxThreadCharacteristicsA-Funktion (avrt.h)

  • Artikel

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
ERROR_INVALID_TASK_INDEX
 Entweder ist TaskIndex beim ersten Aufruf nicht 0 oder wird (bei nachfolgenden Aufrufen) nicht erkannt.
ERROR_INVALID_TASK_NAME
 Die angegebene Aufgabe entspricht keinem der in der Registrierung gespeicherten Aufgaben.
ERROR_PRIVILEGE_NOT_HELD
 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

Weitere Informationen

Multimedia-Klassenplanerdienst