Funzione FltApplyPriorityInfoThread (fltkernel.h)

Articolo
08/07/2023

La routine FltApplyPriorityInfoThread viene usata da un driver minifilter 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 IO_PRIORITY_INFO utilizzata per ricevere lo stato di priorità del thread prima che le informazioni sulla priorità InputPriorityInfo vengano applicate al thread da FltApplyPriorityInfoThread. Questo parametro è facoltativo e può essere NULL.

[in] Thread

Puntatore al thread in cui applicare le informazioni sulla 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 , vengono applicate 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ù dei relativi valori membro non sono validi. Si tratta di un codice di errore.

Commenti

Questa routine è disponibile a partire da Windows Vista.

La routine FltApplyPriorityInfoThread imposta la priorità di I/O, la priorità di paging e la priorità 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 di priorità salvato in precedenza, acquisito dalla routine FltRetrieveIoPriorityInfo o FltApplyPriorityInfoThread , può essere applicato a un thread.

I valori originali del thread di destinazione, prima che i valori di priorità InputPriorityInfo vengano applicati dalla routine FltApplyPriorityInfoThread , possono essere salvati 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 il parametro InputPriorityInfo non sono stati impostati, è necessario impostare questi membri, prima di chiamare la routine FltApplyPriorityInfoThread , 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 .

Requisiti

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