Funzione FltSetIoPriorityHintIntoFileObject (fltkernel.h)

Articolo
02/29/2024

La routine FltSetIoPriorityHintIntoFileObject viene usata da un driver minifilter per impostare le informazioni sulla priorità di I/O in un oggetto file.

Sintassi

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

Parametri

[in] FileObject

Puntatore all'oggetto file da modificare. Questo parametro è obbligatorio e non può essere NULL.

[in] PriorityHint

Valore di enumerazione IO_PRIORITY_HINT da impostare per l'oggetto file a cui punta FileObject.

Valore restituito

Se il valore di priorità I/O passato nel parametro PriorityHint viene applicato correttamente alla struttura FileObject , FltSetIoPriorityHintIntoFileObject restituisce STATUS_SUCCESS. In caso contrario, restituisce un valore NTSTATUS appropriato, ad esempio uno dei seguenti:

Codice restituito	Descrizione
STATUS_INVALID_PARAMETER	Il valore del parametro PriorityHint non è valido. Si tratta di un codice di errore.

Commenti

Questa routine è NONPAGED e può essere chiamata da percorsi di I/O di paging.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows Vista.
Piattaforma di destinazione	Universale
Intestazione	fltkernel.h (include FltKernel.h)
Libreria	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= DISPATCH_LEVEL