Método IWDFRemoteTarget::CloseForQueryRemove (wudfddi.h)

  • Artículo

[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 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.

Comentarios

Si el controlador proporciona una función de devolución de llamada IRemoteTargetCallbackRemoval::OnRemoteTargetQueryRemove , 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 , vea Controlar el estado de un destino de E/S general en UMDF.

Ejemplos

En el ejemplo de código siguiente se muestra una función de devolución de llamada IRemoteTargetCallbackRemoval::OnRemoteTargetQueryRemove 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 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,9
Encabezado wudfddi.h (incluya Wudfddi.h)
Archivo DLL WUDFx.dll

Consulte también

IWDFRemoteTarget

IWDFRemoteTarget::Close