Metodo IWDFRemoteTarget::CloseForQueryRemove (wudfddi.h)

Articolo
02/07/2025

[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 informazioni, vedi Introduzione a UMDF.]

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

Sintassi

HRESULT CloseForQueryRemove();

Valore restituito

Il metodo CloseForQueryRemove restituisce sempre S_OK.

Osservazioni

Se il driver fornisce un IRemoteTargetCallbackRemoval::OnRemoteTargetQueryRemove funzione di callback, 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 Controllo dello stato di una destinazione I/O generale in UMDF.

Esempi

L'esempio di codice seguente illustra un IRemoteTargetCallbackRemoval::OnRemoteTargetQueryRemove funzione di callback 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;
}

Fabbisogno

Requisito	Valore
Fine del supporto	Non disponibile in UMDF 2.0 e versioni successive.
piattaforma di destinazione	Desktop
versione minima di UMDF	1.9
intestazione	wudfddi.h (include Wudfddi.h)
dll	WUDFx.dll

Vedere anche

IWDFRemoteTarget

IWDFRemoteTarget::Close

Condividi tramite