Funzione FltApplyPriorityInfoThread (fltkernel.h)

Articolo
02/06/2025

La routine FltApplyPriorityInfoThread viene utilizzata da un driver minifiltro per applicare informazioni sulla priorità a un thread.

Sintassi

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

Parametri

[in] InputPriorityInfo

Puntatore a una struttura IO_PRIORITY_INFO utilizzata per impostare lo stato di priorità del thread specificato. Questa struttura IO_PRIORITY_INFO deve avere i relativi membri impostati da una routine appropriata. Vedere la sezione Osservazioni seguente. Questo parametro è obbligatorio e non può essere NULL.

[out, optional] OutputPriorityInfo

Puntatore facoltativo a una struttura di IO_PRIORITY_INFO utilizzata per ricevere lo stato di priorità del thread prima che le informazioni di priorità InputPriorityInfo vengano applicate al thread FltApplyPriorityInfoThread. Questo parametro è facoltativo e può essere NULL.

[in] Thread

Puntatore al thread in cui applicare le informazioni di priorità InputPriorityInfo. Questo parametro è obbligatorio e non può essere NULL.

Valore restituito

Se le informazioni sulla priorità del thread, a cui punta il parametro InputPriorityInfo, viene applicata correttamente al thread specificato, la routine FltApplyPriorityInfoThread restituisce STATUS_SUCCESS. In caso contrario, restituisce un valore NTSTATUS appropriato, ad esempio uno dei seguenti:

Codice restituito	Descrizione
STATUS_INVALID_PARAMETER_1	La struttura a cui punta il parametro InputPriorityInfo è stata inizializzata, ma uno o più valori membro non sono validi. Si tratta di un codice di errore.

Osservazioni

Questa routine è disponibile a partire da Windows Vista.

La routine FltApplyPriorityInfoThread imposta la priorità di I/O, la priorità di paging e la priorità thread del thread specificato in base ai valori membro della struttura IO_PRIORITY_INFO a cui punta il parametro InputPriorityInfo. In questo modo, un set di informazioni sulla priorità precedentemente salvato, acquisito dalla routine FltRetrieveIoPriorityInfo o FltApplyPriorityInfoThread, venga applicato a un thread.

I valori originali del thread di destinazione, prima che il InputPriorityInfo valori di priorità vengano applicati dalla routine FltApplyPriorityInfoTh readThread, può essere salvato se viene fornito un puntatore OutputPriorityInfo valido. Si noti che la struttura a cui punta il parametro OutputPriorityInfo non deve essere inizializzata.

È possibile fornire lo stesso puntatore a una singola struttura di IO_PRIORITY_INFO per i parametri InputPriorityInfo e OutputPriorityInfo.

Nota Se i valori membro della struttura IO_PRIORITY_INFO a cui punta la routine InputPriorityInfo non sono stati impostati, è necessario impostare questi membri, prima di chiamare la routine FltApplyPriorityInfoThread Thread utilizzando uno dei metodi seguenti:

Chiamare la routine fltRetrieveIoPriorityInfo.
Assicurarsi che il parametro InputPriorityInfo corrente sia il parametro OutputPriorityInfo in una chiamata precedente alla routine FltApplyPriorityInfoThread.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile in Microsoft Windows Vista e versioni successive dei sistemi operativi Windows.
piattaforma di destinazione	Universale
intestazione	fltkernel.h (include Fltkernel.h)
libreria	Fltmgr.lib
IRQL	<= DISPATCH_LEVEL