FltSetIoPriorityHintIntoFileObject-Funktion (fltkernel.h)

Artikel
02/06/2025

Die FltSetIoPriorityHintIntoFileObject Routine wird von einem Minifiltertreiber verwendet, um die E/A-Prioritätsinformationen in einem Dateiobjekt festzulegen.

Syntax

NTSTATUS FLTAPI FltSetIoPriorityHintIntoFileObject(
  [in] PFILE_OBJECT     FileObject,
  [in] IO_PRIORITY_HINT PriorityHint
);

Parameter

[in] FileObject

Ein Zeiger auf das zu ändernde Dateiobjekt. Dieser Parameter ist erforderlich und kann nicht NULL-werden.

[in] PriorityHint

Der IO_PRIORITY_HINT Enumerationswert, der für das Dateiobjekt festgelegt werden soll, auf das durch FileObjectverwiesen wird.

Rückgabewert

Wenn der im PriorityHint Parameter übergebene E/A-Prioritätswert erfolgreich auf die FileObject--Struktur angewendet wird, gibt FltSetIoPriorityHintIntoFileObject STATUS_SUCCESS zurück. Andernfalls wird ein entsprechender NTSTATUS-Wert zurückgegeben, z. B. einer der folgenden:

Rückgabecode	Beschreibung
STATUS_INVALID_PARAMETER	Der Wert des PriorityHint-Parameters ist ungültig. Dies ist ein Fehlercode.

Bemerkungen

Diese Routine ist NONPAGED und kann von Auslagerungs-E/A-Pfaden aufgerufen werden.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar ab Windows Vista.
Zielplattform-	Universal
Header-	fltkernel.h (include FltKernel.h)
Library	FltMgr.lib
DLL-	Fltmgr.sys
IRQL-	<= DISPATCH_LEVEL