IWDFRemoteTarget::Start-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 in neueren 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 IWDFRemoteTarget::Start-Methode startet ein angehaltenes Remote-E/A-Ziel neu.

Syntax

HRESULT Start();

Rückgabewert

Start gibt S_OK zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt die -Methode möglicherweise den folgenden Wert zurück:

Rückgabecode Beschreibung
HRESULT_FROM_NT (STATUS_INVALID_DEVICE_STATE)
Das Remote-E/A-Zielobjekt wurde gelöscht.
 

Diese Methode gibt möglicherweise einen der anderen Werte zurück, die Winerror.h enthält.

Hinweise

Die Start-Methode setzt die Verarbeitung aller E/A-Anforderungen fort, die sich in der Warteschlange für das Remote-E/A-Ziel befinden. Nachdem ein Treiber IWDFRemoteTarget::Stop aufgerufen hat, muss der Treiber Start aufrufen, damit das Framework das Senden von E/A-Anforderungen an das E/A-Ziel fortsetzen kann.

Weitere Informationen zum Start und zur Verwendung von Remote-E/A-Zielen in UMDF-basierten Treibern finden Sie unter Steuern des Status eines allgemeinen E/A-Ziels in UMDF.

Beispiele

Im folgenden Codebeispiel wird ein Remote-E/A-Ziel neu gestartet.

if (S_OK == RemoteTarget->Start())
{
    //
    // Resume sending I/O requests to the I/O target.
    //
...}

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::Stop