Função IoGetNextIrpStackLocation (wdm.h)

Artigo
02/27/2024

A rotina IoGetNextIrpStackLocation dá a um driver de nível mais alto acesso ao local da pilha de E/S do driver mais baixo em um IRP para que o chamador possa configurá-lo para o driver inferior.

Sintaxe

__drv_aliasesMem PIO_STACK_LOCATION IoGetNextIrpStackLocation(
  [in] PIRP Irp
);

Parâmetros

[in] Irp

Um ponteiro para o IRP.

Retornar valor

IoGetNextIrpStackLocation retorna um ponteiro para o local de pilha de E/S do próximo driver de nível inferior no IRP fornecido.

Comentários

Cada driver que passa IRPs para drivers inferiores deve configurar o local da pilha para o próximo driver inferior. Um driver chama IoGetNextIrpStackLocation para obter um ponteiro para o local da pilha de E/S do driver mais baixo.

Se um driver estiver passando os mesmos parâmetros que recebeu para o driver mais baixo, ele deverá chamar IoCopyCurrentIrpStackLocationToNext ou IoSkipCurrentIrpStackLocation em vez de obter um ponteiro para o local da pilha mais baixa e copiar os parâmetros manualmente.

O valor retornado é um ponteiro para uma estrutura IO_STACK_LOCATION . Para obter mais informações, consulte Locais de pilha de E/S.

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	Qualquer nível