AvSetMmThreadCharacteristicsA-Funktion (avrt.h)

Artikel
11/20/2024

Ordnet den aufrufenden Thread der angegebenen Aufgabe zu.

Syntax

AVRTAPI HANDLE AvSetMmThreadCharacteristicsA(
  [in]      LPCSTR  TaskName,
  [in, out] LPDWORD TaskIndex
);

Parameter

[in] TaskName

Der Name der 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 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
ERROR_INVALID_TASK_INDEX	Entweder TaskIndex- ist für den ersten Aufruf nicht 0 oder wird kein Wert erkannt (bei nachfolgenden Aufrufen).
ERROR_INVALID_TASK_NAME	Die angegebene Aufgabe stimmt nicht mit den vorgängen überein, die in der Registrierung gespeichert sind.
ERROR_PRIVILEGE_NOT_HELD	Der Aufrufer verfügt nicht über ausreichende Berechtigungen.

Bemerkungen

Rufen Sie nach Abschluss der Aufgabe die AvRevertMmThreadCharacteristics-Funktion auf.

Anmerkung

Der avrt.h-Header definiert AvSetMmThreadCharacteristics 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

Siehe auch

Multimedia Class Scheduler Service

Freigeben über