IWDFRemoteTarget::CloseForQueryRemove-Methode (wudfddi.h)

[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 für neuere Versionen von Windows 10 ist eingeschränkt. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF.]

Die CloseForQueryRemove-Methode schließt ein Remote-E/A-Ziel , da das Betriebssystem möglicherweise das Entfernen des Geräts zulässt.

Syntax

HRESULT CloseForQueryRemove();

Rückgabewert

Die CloseForQueryRemove-Methode gibt immer S_OK zurück.

Hinweise

Wenn Ihr Treiber eine IRemoteTargetCallbackRemoval::OnRemoteTargetQueryRemove-Rückruffunktion bereitstellt, muss die Rückruffunktion CloseForQueryRemove aufrufen, wenn sie TRUE zurückgibt, um anzugeben, dass das Gerät entfernt werden kann.

Die CloseForQueryRemove-Methode schließt alle E/A-Anforderungen ab, die der Treiber an das E/A-Ziel gesendet hat.

Nachdem ein Treiber CloseForQueryRemove aufgerufen hat, kann der Treiber keine E/A-Anforderungen an das E/A-Ziel senden, bis er IWDFRemoteTarget::Reopen aufruft.

Weitere Informationen zur CloseForQueryRemove-Methode finden Sie unter Steuern des Status eines allgemeinen E/A-Ziels in UMDF.

Beispiele

Das folgende Codebeispiel zeigt eine IRemoteTargetCallbackRemoval::OnRemoteTargetQueryRemove-Rückruffunktion , die CloseForQueryRemove aufruft.

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;
}

Anforderungen

Anforderung	Wert
Ende des Supports	In UMDF 2.0 und höher nicht verfügbar.
Zielplattform	Desktop
UMDF-Mindestversion	1.9
Kopfzeile	wudfddi.h (include Wudfddi.h)
DLL	WUDFx.dll

Weitere Informationen

IWDFRemoteTarget

IWDFRemoteTarget::Close