Metodo IWDFRemoteTarget::CloseForQueryRemove (wudfddi.h)

[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Non vengono aggiunte nuove funzionalità a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre info, vedi Introduzione con UMDF.]

Il metodo CloseForQueryRemove chiude una destinazione di I/O remota perché il sistema operativo potrebbe consentire la rimozione del dispositivo.

Sintassi

HRESULT CloseForQueryRemove();

Valore restituito

Il metodo CloseForQueryRemove restituisce sempre S_OK.

Commenti

Se il driver fornisce una funzione di callback IRemoteTargetCallbackRemoval::OnRemoteTargetQueryRemove , la funzione di callback deve chiamare CloseForQueryRemove se restituisce TRUE per indicare che il dispositivo può essere rimosso.

Il metodo CloseForQueryRemove completa o annulla tutte le richieste di I/O inviate dal driver alla destinazione di I/O.

Dopo che un driver chiama CloseForQueryRemove, il driver non può inviare richieste di I/O alla destinazione di I/O finché non chiama IWDFRemoteTarget::Reopen.

Per altre informazioni sul metodo CloseForQueryRemove , vedere Controlling a General I/O Target's State in UMDF.For more information about the CloseForQueryRemove method, see Controlling a General I/O Target's State in UMDF.

Esempio

L'esempio di codice seguente mostra una funzione di callback IRemoteTargetCallbackRemoval::OnRemoteTargetQueryRemove che chiama 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;
}

Requisiti

Vedi anche

IWDFRemoteTarget

IWDFRemoteTarget::Close