Método IWDFIoRequest::SetCompletionCallback (wudfddi.h)
[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los controladores UMDF nuevos deben escribirse con UMDF 2. No se agregan nuevas características a UMDF 1 y hay compatibilidad limitada con UMDF 1 en versiones más recientes de Windows 10. Los controladores universales de Windows deben usar UMDF 2. Para obtener más información, consulta Introducción con UMDF.
El método SetCompletionCallback registra la interfaz del método OnCompletion al que el marco debe llamar cuando se completa una solicitud de E/S.
Sintaxis
void SetCompletionCallback(
[in] IRequestCallbackRequestCompletion *pCompletionCallback,
[in, optional] void *pContext
);
Parámetros
[in] pCompletionCallback
Puntero a la interfaz IRequestCallbackRequestCompletion cuyo método OnCompletion llama al marco una vez completada la solicitud de E/S. A partir de la versión 1.9 de UMDF, el controlador puede especificar NULL para anular el registro de un método OnCompletion registrado anteriormente.
[in, optional] pContext
Puntero a un búfer que contiene información de contexto relacionada con la finalización de la solicitud. El marco pasa esta información de contexto en una llamada al método IRequestCallbackRequestCompletion::OnCompletion . Este parámetro es opcional y puede ser NULL.
Valor devuelto
None
Observaciones
Si un controlador que reenvía una solicitud de E/S requiere notificación cuando el controlador de nivel inferior completa la solicitud, el controlador puede proporcionar una rutina de finalización y llamar a SetCompletionCallback para registrar la interfaz IRequestCallbackRequestCompletion para la rutina de finalización. El marco llama a la rutina de finalización después de que el controlador de nivel inferior complete la solicitud de E/S.
Ejemplos
Para obtener un ejemplo de código sobre cómo usar el método SetCompletionCallback , vea IWDFIoRequest::Send.
Requisitos
| Requisito | Value |
|---|---|
| Finalización del soporte técnico | No disponible en UMDF 2.0 y versiones posteriores. |
| Plataforma de destino | Escritorio |
| Versión mínima de UMDF | 1.5 |
| Encabezado | wudfddi.h (incluya Wudfddi.h) |
| Archivo DLL | WUDFx.dll |
Consulte también
IRequestCallbackRequestCompletion