Função IoCopyCurrentIrpStackLocationToNext (wdm.h)

  • Artigo

A rotina IoCopyCurrentIrpStackLocationToNext copia os parâmetros da pilha IRP do local da pilha de E/S atual para o local da pilha do driver mais baixo.

Sintaxe

void IoCopyCurrentIrpStackLocationToNext(
  [in, out] PIRP Irp
);

Parâmetros

[in, out] Irp

Um ponteiro para o IRP.

Retornar valor

Nenhum

Comentários

Um driver chama IoCopyCurrentIrpStackLocationToNext para copiar os parâmetros IRP de seu local de pilha para o local da pilha do próximo driver inferior.

Depois de chamar essa rotina, um driver normalmente define uma rotina de conclusão de E/S com IoSetCompletionRoutine antes de passar o IRP para o driver inferior com IoCallDriver. Os drivers que passam seus parâmetros IRP, mas não definem uma rotina de conclusão de E/S, devem chamar IoSkipCurrentIrpStackLocation em vez dessa rotina.

Se o driver chamar IoSkipCurrentIrpStackLocation, tenha cuidado para não modificar a estrutura IO_STACK_LOCATION de uma maneira que possa afetar involuntariamente o driver inferior ou o comportamento do sistema em relação a esse driver. Em particular, o driver não deve modificar a união parâmetros da estrutura IO_STACK_LOCATION e não deve chamar a rotina IoMarkIrpPending.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível a partir do Windows 2000.
Plataforma de Destino Área de Trabalho
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
IRQL <=DISPATCH_LEVEL

Confira também

IO_STACK_LOCATION

IoCallDriver

IoMarkIrpPending

IoSetCompletionRoutine

IoSkipCurrentIrpStackLocation