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 |