Compartilhar via


Despachando irps para filas de E/S

[Aplica-se a KMDF e UMDF]

Um driver baseado em estrutura pode especificar dinamicamente uma fila de destino para um IRP de entrada. Para expedir um IRP para uma fila específica, um driver deve chamar o método WdfDeviceWdmDispatchIrpToIoQueue .

Normalmente, um driver chama WdfDeviceWdmDispatchIrpToIoQueue de sua função de retorno de chamada EvtDeviceWdmIrpPreprocess ou EvtDeviceWdmIrpDispatch . Para obter o melhor desempenho, a maioria dos drivers não fornece ambas as funções de retorno de chamada.

Nota Um driver UMDF pode fornecer uma função de retorno de chamada EvtDeviceWdmIrpDispatch , mas somente drivers KMDF podem fornecer EvtDeviceWdmIrpPreprocess.

Se o driver já fornecer EvtDeviceWdmIrpPreprocess, você poderá usá-lo para selecionar dinamicamente uma fila. Caso contrário, forneça EvtDeviceWdmIrpDispatch e chame WdfDeviceWdmDispatchIrpToIoQueue de dentro dessa função de retorno de chamada.

Além disso, você deve estar ciente do seguinte:

Expedindo IRPs não pré-processados

Para expedir IRPs da função de retorno de chamada EvtDeviceWdmIrpDispatch de um driver, use o seguinte procedimento:

  1. Em sua função de retorno de chamada EvtDriverDeviceAdd , o driver chama WdfDeviceConfigureWdmIrpDispatchCallback para registrar uma função de retorno de chamada EvtDeviceWdmIrpDispatch .

    Se o destino for a fila de E/S do dispositivo pai, um driver KMDF deverá chamar WdfPdoInitAllowForwardingRequestToParent antes de chamar WdfDeviceCreate. Se um driver KMDF também tiver fornecido uma função de retorno de chamada EvtDeviceWdmIrpPreprocess , a estrutura chamará essa função primeiro quando um IRP chegar. Depois que a função de retorno de chamada pré-processa a solicitação, ela chama WdfDeviceWdmDispatchPreprocessedIrp para retornar o IRP para a estrutura.

  2. A estrutura chama a função de retorno de chamada EvtDeviceWdmIrpDispatch do driver.

  3. De dentro de EvtDeviceWdmIrpDispatch, o driver pode chamar WdfDeviceWdmDispatchIrpToIoQueue ou WdfDeviceWdmDispatchIrp, mas não ambos. Um driver KMDF tem a opção adicional de chamar nenhum desses métodos e, em vez disso, concluir o IRP ou marcá-lo pendente.

  4. Se um driver KMDF tiver definido o sinalizador WDF_DISPATCH_IRP_TO_IO_QUEUE_INVOKE_INCALLERCTX_CALLBACK e não tiver habilitado o progresso de encaminhamento garantido para a fila de E/S de destino, a estrutura chamará EvtIoInCallerContext do driver, se fornecido. Depois de pré-processar a solicitação, a função de retorno de chamada deve enfileira-la chamando WdfDeviceEnqueueRequest ou conclua-a chamando WdfRequestComplete.

Expedição de IRPs pré-processados

Para expedir IRPs da função de retorno de chamada EvtDeviceWdmIrpPreprocess de um driver para uma fila de E/S específica, use o seguinte procedimento:

  1. O driver registra uma função de retorno de chamada EvtDeviceWdmIrpPreprocess chamando WdfDeviceInitAssignWdmIrpPreprocessCallback.
  2. O driver chamará WdfPdoInitAllowForwardingRequestToParent se o destino for a fila de E/S do dispositivo pai.
  3. Em EvtDeviceWdmIrpPreprocess, chame WdfDeviceWdmDispatchIrpToIoQueue com Sinalizadores definidos como WDF_DISPATCH_IRP_TO_IO_QUEUE_PREPROCESSED_IRP.
  4. Se o driver tiver definido o sinalizador WDF_DISPATCH_IRP_TO_IO_QUEUE_INVOKE_INCALLERCTX_CALLBACK e não tiver habilitado o progresso de encaminhamento garantido para a fila de E/S de destino, a estrutura chamará EvtIoInCallerContext do driver, se fornecido. Depois que a função de retorno de chamada tiver terminado de pré-processar a solicitação, ela deverá enfileira-la chamando WdfDeviceEnqueueRequest ou conclua-a chamando WdfRequestComplete.