Partilhar via


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 em EvtDeviceWdmIrpDispatch retorno de chamada.

Valor de retorno

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 chamada WdfDeviceWdmDispatchIrp.

Uma verificação de bug ocorre se um driver KMDF fornece um identificador de objeto inválido. Se um driver UMDF fornecer um identificador inválido, o processo de host do driver será encerrado.

Observações

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 de processamento padrão em vez de expedi-lo para uma fila específica.

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

Requisitos

Requisito Valor
da 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 de DDI DriverCreate(kmdf)

Consulte também

EvtDeviceWdmIrpDispatch

WdfDeviceWdmDispatchIrpToIoQueue