Función WdfRequestSetCompletionRoutine (wdfrequest.h)
[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) |