Função IoForwardIrpSynchronously (wdm.h)
A rotina IoForwardIrpSynchronously envia um IRP para um driver especificado e aguarda o driver concluir o IRP.
Sintaxe
BOOLEAN IoForwardIrpSynchronously(
[in] PDEVICE_OBJECT DeviceObject,
[in] PIRP Irp
);
Parâmetros
[in] DeviceObject
Especifica o objeto de dispositivo do driver para o qual o IRP é enviado.
[in] Irp
Especifica o IRP a ser enviado.
Retornar valor
IoForwardIrpSynchronously retornará TRUE se o IRP for enviado com êxito. Caso contrário, retornará FALSE.
Comentários
Use a rotina IoForwardIrpSynchronously para encaminhar de forma síncrona o IRP atual para o próximo driver na pilha. (Para encaminhar de forma assíncrona o IRP, use as rotinas IoCopyCurrentIrpStackLocationToNext, IoCallDriver e IoSetCompletionRoutine .)
A rotina IoForwardIrpSynchronously copia o local da pilha atual para o próximo local da pilha. Esse local de pilha é então usado como o local da pilha atual pelo driver especificado em DeviceObject. Se nenhum próximo local de pilha estiver disponível, a rotina retornará FALSE. Se a rotina retornar TRUE, o IRP será enviado para o driver especificado e esse driver concluirá o processamento desse IRP.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows XP e versões posteriores do Windows. |
| Plataforma de Destino | Universal |
| Cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Biblioteca | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |
| Regras de conformidade de DDI | PnpIrpCompletion(wdm) |