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 nuevos controladores UMDF deben escribirse mediante 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 a UMDF.]
El método SetCompletionCallback registra la interfaz del método OnCompletion al que debe llamar el marco 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 de IRequestCallbackRequestCompletion cuya 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 se puede NULL.
Valor devuelto
Ninguno
Observaciones
Si un controlador que reenvía una solicitud de E/S requiere una 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 el IRequestCallbackRequestCompletion interfaz 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 de cómo usar el método setCompletionCallback de, vea IWDFIoRequest::Send.
Requisitos
| Requisito | Valor |
|---|---|
| fin del soporte técnico | No disponible en UMDF 2.0 y versiones posteriores. |
| de la plataforma de destino de | Escritorio |
| versión mínima de UMDF | 1.5 |
| encabezado de | wudfddi.h (incluya Wudfddi.h) |
| DLL de | WUDFx.dll |
Consulte también
IRequestCallbackRequestCompletion