Função FltApplyPriorityInfoThread (fltkernel.h)

Artigo
02/29/2024

A rotina FltApplyPriorityInfoThread é usada por um driver de minifiltro para aplicar informações de prioridade a um thread.

Sintaxe

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

Parâmetros

[in] InputPriorityInfo

Um ponteiro para uma estrutura IO_PRIORITY_INFO usada para definir o estado de prioridade do thread fornecido. Essa estrutura IO_PRIORITY_INFO deve ter seus membros definidos por uma rotina apropriada – consulte a seção Comentários a seguir. Esse parâmetro é necessário e não pode ser NULL.

[out, optional] OutputPriorityInfo

Um ponteiro opcional para uma estrutura IO_PRIORITY_INFO usada para receber o estado de prioridade do thread antes que as informações de prioridade InputPriorityInfo sejam aplicadas ao thread por FltApplyPriorityInfoThread. Esse parâmetro é opcional e pode ser NULL.

[in] Thread

Um ponteiro para o thread ao qual aplicar as informações de prioridade InputPriorityInfo . Esse parâmetro é necessário e não pode ser NULL.

Retornar valor

Se as informações de prioridade de thread, apontadas pelo parâmetro InputPriorityInfo , forem aplicadas com êxito ao thread fornecido, a rotina FltApplyPriorityInfoThread retornará STATUS_SUCCESS. Caso contrário, ele retornará um valor NTSTATUS apropriado, como um dos seguintes:

Código de retorno	Descrição
STATUS_INVALID_PARAMETER_1	A estrutura apontada pelo parâmetro InputPriorityInfo foi inicializada, mas um ou mais de seus valores de membro são inválidos. Este é um código de erro.

Comentários

Essa rotina está disponível a partir do Windows Vista.

A rotina FltApplyPriorityInfoThread define a prioridade de E/S, a prioridade de paginação e a prioridade de thread do thread fornecido com base nos valores de membro da estrutura de IO_PRIORITY_INFO apontada pelo parâmetro InputPriorityInfo . Isso permite que um conjunto salvo anteriormente de informações de prioridade, adquirido pela rotina FltRetrieveIoPriorityInfo ou FltApplyPriorityInfoThread , seja aplicado a um thread.

Os valores originais do thread de destino, antes que os valores de prioridade InputPriorityInfo sejam aplicados pela rotina FltApplyPriorityInfoThread , poderão ser salvos se um ponteiro OutputPriorityInfo válido for fornecido. Observe que a estrutura apontada pelo parâmetro OutputPriorityInfo não precisa ser inicializada.

É seguro fornecer o mesmo ponteiro para uma única estrutura IO_PRIORITY_INFO para os parâmetros InputPriorityInfo e OutputPriorityInfo .

Nota Se os valores de membro da estrutura IO_PRIORITY_INFO apontada pelo parâmetro InputPriorityInfo não tiverem sido definidos, você deverá definir esses membros antes de chamar a rotina FltApplyPriorityInfoThread usando um dos seguintes métodos:

Chame a rotina FltRetrieveIoPriorityInfo .
Verifique se o parâmetro InputPriorityInfo atual era o parâmetro OutputPriorityInfo em uma chamada anterior à rotina FltApplyPriorityInfoThread .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Microsoft Windows Vista e versões posteriores de sistemas operacionais Windows.
Plataforma de Destino	Universal
Cabeçalho	fltkernel.h (inclua Fltkernel.h)
Biblioteca	Fltmgr.lib
IRQL	<= DISPATCH_LEVEL