Função WdfDeviceWdmDispatchIrp (wdfdevice.h)

[Aplica-se a KMDF e UMDF]

O método WdfDeviceWdmDispatchIrp retorna um IRP expedido para a estrutura de EvtDeviceWdmIrpDispatch.

Sintaxe

NTSTATUS WdfDeviceWdmDispatchIrp(
  [in] WDFDEVICE  Device,
  [in] PIRP       Irp,
  [in] WDFCONTEXT DispatchContext
);

Parâmetros

[in] Device

Um identificador para um objeto de dispositivo de estrutura.

[in] Irp

Um ponteiro para uma estrutura IRP.

[in] DispatchContext

O parâmetro de contexto de expedição que o driver recebeu no retorno de chamada EvtDeviceWdmIrpDispatch .

Retornar valor

O método WdfDeviceWdmDispatchIrp 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 EvtDeviceWdmIrpDispatch que chamou WdfDeviceWdmDispatchIrp.

Um bug marcar ocorrerá se um driver KMDF fornecer um identificador de objeto inválido. Se um driver UMDF fornecer um identificador inválido, o processo de host do driver será encerrado.

Comentários

Se o driver fornecer uma função de retorno de chamada EvtDeviceWdmIrpDispatch , você poderá chamar WdfDeviceWdmDispatchIrp de dentro da função de retorno de chamada para retornar o IRP para a estrutura para processamento padrão em vez de expedir para uma fila específica.

Para obter mais informações sobre como especificar filas para IRPs à medida que elas chegam, consulte Expedindo IRPs para filas de E/S.

Requisitos

Requisito Valor
Plataforma de Destino Universal
Versão mínima do KMDF 1.11
Versão mínima do UMDF 2.17
Cabeçalho wdfdevice.h (inclua Wdf.h)
Biblioteca Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <= DISPATCH_LEVEL
Regras de conformidade da DDI DriverCreate(kmdf)

Confira também

EvtDeviceWdmIrpDispatch

WdfDeviceWdmDispatchIrpToIoQueue