Função WdfDeviceWdmDispatchPreprocessedIrp (wdfdevice.h)

Artigo
03/22/2025

[Aplica-se somente ao KMDF]

O método WdfDeviceWdmDispatchPreprocessedIrp retorna um IRP pré-processado para a estrutura.

Sintaxe

NTSTATUS WdfDeviceWdmDispatchPreprocessedIrp(
  [in] WDFDEVICE Device,
  [in] PIRP      Irp
);

Parâmetros

[in] Device

Um identificador para um objeto de dispositivo de estrutura.

[in] Irp

Um ponteiro para uma estrutura de IRP.

Valor de retorno

WdfDeviceWdmDispatchPreprocessedIrp retorna um valor NTSTATUS que a estrutura ou o driver fornece como resultado do processamento do IRP. O driver deve usar esse valor retornado como o valor retornado para a função de retorno de chamada EvtDeviceWdmIrpPreprocess.

Uma verificação de bug ocorre se o driver fornece um identificador de objeto inválido.

Observações

Um driver baseado em estrutura que pré-processa ou pós-processa OS IRPs do WDM deve chamar WdfDeviceWdmDispatchPreprocessedIrp, normalmente de dentro do do driver EvtDeviceWdmIrpPreprocess função de retorno de chamada. Para obter mais informações sobre como chamar WdfDeviceWdmDispatchPreprocessedIrp, consulte de IRPs de pré-processamento e pós-processamento.

Exemplos

Para obter um exemplo de código que usa WdfDeviceWdmDispatchPreprocessedIrp, consulte o pré-processamento e o pós-processamento de IRPs.

Requisitos

Requisito	Valor
da Plataforma de Destino	Universal
versão mínima do KMDF	1.0
cabeçalho	wdfdevice.h (inclua Wdf.h)
Biblioteca	Wdf01000.sys (consulte o Controle de Versão da Biblioteca da Estrutura.)
IRQL	<= DISPATCH_LEVEL
regras de conformidade de DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Partilhar via