Método IWDFRemoteTarget::CloseForQueryRemove (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 CloseForQueryRemove cierra un destino de E/S remoto porque el sistema operativo podría permitir que se quite el dispositivo.
Sintaxis
HRESULT CloseForQueryRemove();
Valor devuelto
El método CloseForQueryRemove siempre devuelve S_OK.
Observaciones
Si el controlador proporciona un IRemoteTargetCallbackRemoval::OnRemoteTargetQueryRemove función de devolución de llamada, la función de devolución de llamada debe llamar a CloseForQueryRemove si devuelve TRUE para indicar que se puede quitar el dispositivo.
El método CloseForQueryRemove completa o cancela todas las solicitudes de E/S que el controlador ha enviado al destino de E/S.
Después de que un controlador llame a CloseForQueryRemove, el controlador no puede enviar solicitudes de E/S al destino de E/S hasta que llame a IWDFRemoteTarget::Reopen.
Para obtener más información sobre el método CloseForQueryRemove, consulte Control de un estado de destino de E/S general en umDF.
Ejemplos
En el ejemplo de código siguiente se muestra un función de devolución de llamada IRemoteTargetCallbackRemoval::OnRemoteTargetQueryRemove función de devolución de llamada que llama a CloseForQueryRemove.
BOOL
STDMETHODCALLTYPE
CMyRemoteTarget::OnRemoteTargetQueryRemove(
__in IWDFRemoteTarget *FxTarget
)
{
//
// Here, do any driver-specific actions that your driver requires
// to stop sending I/O requests to the I/O target.
//
...
//
// Close the target.
//
FxTarget->CloseForQueryRemove();
//
// Return TRUE if you want to allow removal of the device.
//
return TRUE;
}
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 |