FltSetIoPriorityHintIntoFileObject-Funktion (fltkernel.h)

Artikel
02/29/2024

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 darf nicht NULL sein.

[in] PriorityHint

Der IO_PRIORITY_HINT Enumerationswert, der für das Dateiobjekt festgelegt werden soll, auf das FileObject verweist.

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 geeigneter NTSTATUS-Wert zurückgegeben, z. B. einer der folgenden:

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

Hinweise

Diese Routine ist NONPAGED und kann aus Paging-E/A-Pfaden aufgerufen werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows Vista.
Zielplattform	Universell
Header	fltkernel.h (fltKernel.h einschließen)
Bibliothek	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= DISPATCH_LEVEL