Compartilhar via


Função IoGetTopLevelIrp (ntifs.h)

A rotina IoGetTopLevelIrp retorna o valor do campo TopLevelIrp do thread atual.

Sintaxe

PIRP IoGetTopLevelIrp();

Retornar valor

IoGetTopLevelIrp retorna o valor do campo TopLevelIrp do thread atual.

Comentários

IoGetTopLevelIrp pode retornar NULL, um valor arbitrário específico do sistema de arquivos (como um ponteiro para o IRP atual) ou um dos sinalizadores listados na tabela a seguir.

Se o thread atual não tiver recursos acima do sistema de arquivos, IoGetTopLevelIrp retornará NULL.

Se o sistema de arquivos for o componente de nível superior do thread atual, IoGetTopLevelIrp retornará um ponteiro para o IRP atual.

Se um componente diferente do sistema de arquivos for o componente de nível superior do thread atual, IoGetTopLevelIrp retornará um dos seguintes sinalizadores:

Sinalizador Significado
FSRTL_FSP_TOP_LEVEL_IRP Essa é uma chamada recursiva.
FSRTL_CACHE_TOP_LEVEL_IRP O gerenciador de cache é o componente de nível superior do thread atual.
FSRTL_MOD_WRITE_TOP_LEVEL_IRP O gravador de página modificado é o componente de nível superior do thread atual.
FSRTL_FAST_IO_TOP_LEVEL_IRP O gerenciador de cache é o componente de nível superior do thread atual e o thread atual está em um caminho de E/S rápido.

Requisitos

Requisito Valor
Plataforma de Destino Universal
Cabeçalho ntifs.h (inclua Ntifs.h, Wdm.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL

Confira também

IoSetTopLevelIrp