Função IoGetTopLevelIrp (wdm.h)
A rotina de IoGetTopLevelIrp retorna o valor do campo TopLevelIrp do thread atual.
Sintaxe
PIRP IoGetTopLevelIrp();
Valor de retorno
IoGetTopLevelIrp retorna o valor do campo TopLevelIrp do thread atual.
Observações
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:
| Bandeira | 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 |
|---|---|
| da Plataforma de Destino | Universal |
| cabeçalho | wdm.h (include Ntifs.h, Wdm.h) |
| biblioteca | NtosKrnl.lib |
| de DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |