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 |