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. Es werden keine neuen Features zu UMDF 1 hinzugefügt, und es gibt eingeschränkte Unterstützung für UMDF 1 für neuere Versionen von Windows 10. 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.

Bemerkungen

Wenn Ihr Treiber eine IRemoteTargetCallbackRemoval::OnRemoteTargetQueryRemove Rückruffunktion bereitstellt, muss die Rückruffunktion CloseForQueryRemove aufrufen, wenn TRUE- zurückgegeben wird, 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 CloseForQueryRemoveaufgerufen hat, kann der Treiber keine E/A-Anforderungen an das E/A-Ziel senden, bis er IWDFRemoteTarget::Reopenaufruft.

Weitere Informationen zur CloseForQueryRemove--Methode finden Sie unter Controlling a General I/O Target's State in UMDF.

Beispiele

Das folgende Codebeispiel zeigt eine IRemoteTargetCallbackRemoval::OnRemoteTargetQueryRemove Rückruffunktion, die CloseForQueryRemoveaufruft.

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
Mindest-UMDF-Version	1.9
Header-	wudfddi.h (include Wudfddi.h)
DLL-	WUDFx.dll

Siehe auch

IWDFRemoteTarget-

IWDFRemoteTarget::Close