Función WdfRequestSetCompletionRoutine (wdfrequest.h)

  • Artículo

[Se aplica a KMDF y UMDF]

El método WdfRequestSetCompletionRoutine registra o anula el registro de una rutina de finalización para el objeto de solicitud de marco especificado.

Sintaxis

void WdfRequestSetCompletionRoutine(
  [in]           WDFREQUEST                         Request,
  [in, optional] PFN_WDF_REQUEST_COMPLETION_ROUTINE CompletionRoutine,
  [in, optional] __drv_aliasesMem WDFCONTEXT        CompletionContext
);

Parámetros

[in] Request

Identificador de un objeto de solicitud de marco.

[in, optional] CompletionRoutine

Puntero a una función de devolución de llamada CompletionRoutine , si el controlador está registrando una rutina de finalización o NULL del controlador está anulando el registro de una rutina de finalización registrada anteriormente.

[in, optional] CompletionContext

Puntero sin tipo a la información de contexto definida por el controlador que el marco pasa a la función de devolución de llamada CompletionRoutine . Este parámetro es opcional y puede ser NULL.

Valor devuelto

None

Observaciones

Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.

Si el controlador reenvía solicitudes de E/S, pero si desea que se le notifique cuando un controlador de nivel inferior complete la solicitud, el controlador puede proporcionar una función de devolución de llamada CompletionRoutine y llamar a WdfRequestSetCompletionRoutine para registrar la función. El marco llama a la función de devolución de llamada después de que un controlador de nivel inferior complete la solicitud de E/S.

Para obtener más información sobre WdfRequestSetCompletionRoutine, consulte Finalización de solicitudes de E/S.

Ejemplos

Para obtener un ejemplo de código que usa WdfRequestSetCompletionRoutine, vea WdfRequestSend.

Requisitos

Requisito Value
Plataforma de destino Universal
Versión mínima de KMDF 1.0
Versión mínima de UMDF 2.0
Encabezado wdfrequest.h (incluir Wdf.h)
Library Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
Reglas de cumplimiento de DDI DriverCreate(kmdf), InvalidReqAccess(kmdf), InvalidReqAccessLocal(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), ReqCompletionRoutine(kmdf)

Consulte también

CompletionRoutine