EVT_WDF_REQUEST_COMPLETION_ROUTINE función de devolución de llamada (wdfrequest.h)

[Se aplica a KMDF y UMDF]

La función de devolución de llamada de eventos CompletionRoutine de un controlador se ejecuta cuando otro controlador completa una solicitud de E/S especificada.

Sintaxis

EVT_WDF_REQUEST_COMPLETION_ROUTINE EvtWdfRequestCompletionRoutine;

void EvtWdfRequestCompletionRoutine(
  [in] WDFREQUEST Request,
  [in] WDFIOTARGET Target,
  [in] PWDF_REQUEST_COMPLETION_PARAMS Params,
  [in] WDFCONTEXT Context
)
{...}

Parámetros

[in] Request

Identificador de un objeto de solicitud de marco que representa la solicitud de E/S completada.

[in] Target

Identificador de un objeto de destino de E/S que representa el destino de E/S que completó la solicitud.

[in] Params

Puntero a una estructura de WDF_REQUEST_COMPLETION_PARAMS que contiene información sobre la solicitud completada. Consulte la nota siguiente con respecto a la validez de los parámetros de finalización.

[in] Context

Información de contexto proporcionada por el controlador, que el controlador especificó en una llamada anterior a WdfRequestSetCompletionRoutine.

Valor devuelto

None

Observaciones

Para registrar una función de devolución de llamada CompletionRoutine para una solicitud de E/S, un controlador debe llamar a WdfRequestSetCompletionRoutine. Para obtener más información sobre esta función de devolución de llamada, consulte Finalización de solicitudes de E/S.

La estructura de parámetros de finalización se rellena completamente con información válida solo si el controlador ha dado formato a la solicitud llamando a una de las siguientes opciones:

• Métodos WdfIoTargetFormatXxx , por ejemplo WdfIoTargetFormatRequestForRead
• Métodos WdfUsbTargetDeviceFormatRequestForXxx , por ejemplo WdfUsbTargetDeviceFormatRequestForString
• Métodos WdfUsbTargetPipeFormatRequestForXxx , por ejemplo WdfUsbTargetPipeFormatRequestForWrite

Si el controlador da formato a la solicitud mediante WdfRequestFormatRequestUsingCurrentType o WdfRequestWdmFormatUsingStackLocation, solo el campo IoStatus de la estructura de parámetros de finalización es válido.

Un controlador KMDF CompletionRoutine se puede ejecutar en IRQL <= DISPATCH_LEVEL independientemente del valor ExecutionLevel especificado en la estructura WDF_OBJECT_ATTRIBUTES para el objeto de solicitud de E/S.

Ejemplos

El tipo de función se declara en Wdfrequest.h, como se indica a continuación.

typedef VOID
  (EVT_WDF_REQUEST_COMPLETION_ROUTINE)(
    IN WDFREQUEST  Request,
    IN WDFIOTARGET  Target,
    IN PWDF_REQUEST_COMPLETION_PARAMS  Params,
    IN WDFCONTEXT  Context
    );

Para definir una función de devolución de llamada CompletionRoutine denominada MyCompletionRoutine, primero debe proporcionar una declaración de función que requieren SDV y otras herramientas de comprobación, como se indica a continuación:

EVT_WDF_REQUEST_COMPLETION_ROUTINE  MyCompletionRoutine;

A continuación, implemente la función de devolución de llamada de la siguiente manera:

VOID
 MyCompletionRoutine (
    IN WDFREQUEST  Request,
    IN WDFIOTARGET  Target,
    IN PWDF_REQUEST_COMPLETION_PARAMS  Params,
    IN WDFCONTEXT  Context
    )
  {...}

Requisitos

Consulte también

WDF_REQUEST_COMPLETION_PARAMS

WdfRequestSetCompletionRoutine