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 un CompletionRoutine función de devolución de llamada, si el controlador registra una rutina de finalización o null del controlador está anulando el registro de una rutina de finalización registrada previamente.
[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 se puede NULL.
Valor devuelto
Ninguno
Observaciones
Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.
Si el controlador reenvía las 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 función de devolución de llamada 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 | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| versión mínima de KMDF | 1.0 |
| versión mínima de UMDF | 2.0 |
| encabezado de | wdfrequest.h (incluya Wdf.h) |
| biblioteca de | 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) |