Método IWDFIoRequest::SetCompletionCallback (wudfddi.h)

Artículo
02/27/2024

[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