FltApplyPriorityInfoThread-Funktion (fltkernel.h)

Artikel
03/05/2024

Die FltApplyPriorityInfoThread-Routine wird von einem Minifiltertreiber verwendet, um Prioritätsinformationen auf einen Thread anzuwenden.

Syntax

NTSTATUS FLTAPI FltApplyPriorityInfoThread(
  [in]            PIO_PRIORITY_INFO InputPriorityInfo,
  [out, optional] PIO_PRIORITY_INFO OutputPriorityInfo,
  [in]            PETHREAD          Thread
);

Parameter

[in] InputPriorityInfo

Ein Zeiger auf eine IO_PRIORITY_INFO Struktur, die verwendet wird, um den Prioritätsstatus des angegebenen Threads festzulegen. Für diese IO_PRIORITY_INFO Struktur müssen die Elemente von einer entsprechenden Routine festgelegt werden. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise". Dieser Parameter ist erforderlich und darf nicht NULL sein.

[out, optional] OutputPriorityInfo

Ein optionaler Zeiger auf eine IO_PRIORITY_INFO Struktur, die verwendet wird, um den Prioritätsstatus des Threads zu empfangen, bevor die InputPriorityInfo-Prioritätsinformationen von FltApplyPriorityInfoThread auf den Thread angewendet werden. Dieser Parameter ist optional und kann NULL sein.

[in] Thread

Ein Zeiger auf den Thread, in dem die InputPriorityInfo-Prioritätsinformationen angewendet werden sollen. Dieser Parameter ist erforderlich und darf nicht NULL sein.

Rückgabewert

Wenn die Threadpriority-Prioritätsinformationen, auf die vom Parameter InputPriorityInfo verwiesen wird, erfolgreich auf den angegebenen Thread angewendet werden, gibt die FltApplyPriorityInfoThread-Routine STATUS_SUCCESS zurück. Andernfalls wird ein entsprechender NTSTATUS-Wert zurückgegeben, z. B. einer der folgenden:

Rückgabecode	Beschreibung
STATUS_INVALID_PARAMETER_1	Die Struktur, auf die der Parameter InputPriorityInfo verweist, wurde initialisiert, aber mindestens ein Elementwert ist ungültig. Dies ist ein Fehlercode.

Hinweise

Diese Routine ist ab Windows Vista verfügbar.

Die FltApplyPriorityInfoThread-Routine legt die E/A-Priorität, Pagingpriorität und Threadpriorität des angegebenen Threads basierend auf den Memberwerten der IO_PRIORITY_INFO-Struktur fest, auf die der InputPriorityInfo-Parameter verweist. Dadurch kann ein zuvor gespeicherter Satz von Prioritätsinformationen, die von der FltRetrieveIoPriorityInfo - oder FltApplyPriorityInfoThread-Routine abgerufen wurden, auf einen Thread angewendet werden.

Die ursprünglichen Werte des Zielthreads, bevor die InputPriorityInfo-Prioritätswerte von der FltApplyPriorityInfoThread-Routine angewendet werden, können gespeichert werden, wenn ein gültiger OutputPriorityInfo-Zeiger angegeben wird. Beachten Sie, dass die Struktur, auf die der OutputPriorityInfo-Parameter verweist, nicht initialisiert werden muss.

Es ist sicher, denselben Zeiger auf eine einzelne IO_PRIORITY_INFO Struktur für die Parameter InputPriorityInfo und OutputPriorityInfo bereitzustellen.

Hinweis Wenn die Memberwerte der IO_PRIORITY_INFO Struktur, auf die der Parameter InputPriorityInfo verweist, nicht festgelegt wurden, müssen Sie diese Member festlegen, bevor Sie die FltApplyPriorityInfoThread-Routine aufrufen, indem Sie eine der folgenden Methoden verwenden:

Rufen Sie die FltRetrieveIoPriorityInfo-Routine auf.
Stellen Sie sicher, dass der aktuelle InputPriorityInfo-Parameter der OutputPriorityInfo-Parameter in einem vorherigen Aufruf der FltApplyPriorityInfoThread-Routine war.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Microsoft Windows Vista und höheren Versionen von Windows-Betriebssystemen.
Zielplattform	Universell
Header	fltkernel.h (include Fltkernel.h)
Bibliothek	Fltmgr.lib
IRQL	<= DISPATCH_LEVEL