AvSetMmThreadCharacteristicsA-Funktion (avrt.h)

  • Artikel

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 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, wird 0 zurückgegeben. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen abzurufen.

Im Folgenden finden Sie mögliche Fehlercodes.

Rückgabecode Beschreibung
ERROR_INVALID_TASK_INDEX
 Entweder ist TaskIndex beim ersten Aufruf nicht 0 oder wird nicht erkannt (bei nachfolgenden Aufrufen).
ERROR_INVALID_TASK_NAME
 Die angegebene Aufgabe stimmt mit keiner der in der Registrierung gespeicherten Aufgaben überein.
ERROR_PRIVILEGE_NOT_HELD
 Der Aufrufer verfügt nicht über ausreichende Berechtigungen.

Hinweise

Wenn die Aufgabe abgeschlossen ist, rufen Sie die AvRevertMmThreadCharacteristics-Funktion auf.

Hinweis

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
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 Class Scheduler Service