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