Função KsForwardIrp (ks.h)

A função KsForwardIrp encaminha um IRP para o driver especificado depois de inicializar o próximo local da pilha e definir o objeto de arquivo.

Sintaxe

KSDDKAPI NTSTATUS KsForwardIrp(
  [in] PIRP         Irp,
  [in] PFILE_OBJECT FileObject,
  [in] BOOLEAN      ReuseStackLocation
);

Parâmetros

[in] Irp

Especifica o IRP que está sendo encaminhado para o driver especificado.

[in] FileObject

Especifica o objeto de arquivo com o qual inicializar a próxima pilha.

[in] ReuseStackLocation

Especifica o novo local da pilha.

Retornar valor

A função KsForwardIrp retorna o resultado do IoCallDriver ou retorna um status inválido se não houver mais profundidade de pilha disponível.

Comentários

Use a função KsForwardIrp quando apenas o parâmetro FileObject do IRP encaminhado for alterado quando os parâmetros de pilha atuais forem copiados para o próximo local da pilha. A função verifica se há um novo local de pilha para copiar antes de tentar copiar. Se não houver um novo local de pilha, o IRP será concluído com STATUS_INVALID_DEVICE_REQUEST.

Requisitos