Método IWDFIoRequest2::Reuse (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 Reutilizar reinicializa un objeto de solicitud de marco para que se pueda reutilizar.
Sintaxis
void Reuse(
[in] HRESULT hrNewStatus
);
Parámetros
[in] hrNewStatus
Valor de estado con tipo HRESULT que el marco asigna a la solicitud.
Valor devuelto
Ninguno
Observaciones
Si un controlador basado en marco llama a IWDFDevice::CreateRequest para crear objetos de solicitud, el controlador puede reutilizar esos objetos de solicitud. Los controladores también pueden reutilizar los objetos de solicitud que reciben del marco en sus colas de E/S.
Un controlador puede reutilizar un objeto de solicitud una vez completada la solicitud original. Después de llamar a un controlador Reutilizar, el contenido de la solicitud debe reinicializarse.
Si desea que la solicitud reutilizada tenga una IRequestCallbackRequestCompletion::OnCompletion función de devolución de llamada, el controlador debe llamar a IWDFIoRequest::SetCompletionCallback después de llamar a Reutilización.
Para obtener más información sobre Reutilización de, vea Reutilización de objetos de solicitud de marco.
Ejemplos
En el ejemplo de código siguiente se muestra cómo una función de devolución de llamada IRequestCallbackRequestCompletion::OnCompletion puede obtener la interfaz de devolución de llamada de IWDFIoRequest2 y, a continuación, llamar a Reutilizar.
void
STDMETHODCALLTYPE
CMyRemoteDevice::OnCompletion(
__in IWDFIoRequest* FxRequest,
__in IWDFIoTarget* FxTarget,
__in IWDFRequestCompletionParams* Params,
__in void* Context
)
{
...
CComQIPtr<IWDFIoRequest2> fxRequest2(FxRequest);
fxRequest2->Reuse(S_OK);
...
}
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.9 |
| encabezado de | wudfddi.h (incluya Wudfddi.h) |
| DLL de | WUDFx.dll |