IWDFIoRequest2::Reuse-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 Reuse-Methode initialisiert ein Frameworkanforderungsobjekt neu, damit es wiederverwendet werden kann.

Syntax

void Reuse(
  [in] HRESULT hrNewStatus
);

Parameter

[in] hrNewStatus

Ein HRESULT-typisierter status Wert, den das Framework der Anforderung zuweist.

Rückgabewert

Keine

Bemerkungen

Wenn ein frameworkbasierter Treiber IWDFDevice::CreateRequest aufruft, um Anforderungsobjekte zu erstellen, kann der Treiber diese Anforderungsobjekte wiederverwenden. Treiber können auch Anforderungsobjekte, die sie vom Framework erhalten, in ihren E/A-Warteschlangen wiederverwenden.

Ein Treiber kann ein Anforderungsobjekt wiederverwenden, nachdem die ursprüngliche Anforderung abgeschlossen wurde. Nachdem ein Treiber wiederverwenden aufgerufen hat, muss der Inhalt der Anforderung erneut initialisiert werden.

Wenn die wiederverwendete Anforderung über eine IRequestCallbackRequestCompletion::OnCompletion-Rückruffunktion verfügen soll, muss der Treiber IWDFIoRequest::SetCompletionCallback aufrufen, nachdem er Reuse aufgerufen hat.

Weitere Informationen zur Wiederverwendung finden Sie unter Wiederverwenden von Frameworkanforderungsobjekten.

Beispiele

Das folgende Codebeispiel zeigt, wie eine IRequestCallbackRequestCompletion::OnCompletion-Rückruffunktion die IWDFIoRequest2-Schnittstelle abrufen und dann Wiederverwenden aufrufen kann.

void 
STDMETHODCALLTYPE
CMyRemoteDevice::OnCompletion(
    __in IWDFIoRequest*  FxRequest,
    __in IWDFIoTarget*  FxTarget,
    __in IWDFRequestCompletionParams*  Params,
    __in void*  Context
    )
{
...
    CComQIPtr<IWDFIoRequest2> fxRequest2(FxRequest);
    fxRequest2->Reuse(S_OK);
...
}

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

IRequestCallbackRequestCompletion::OnCompletion

IWDFIoRequest2

IWDFIoRequest::SetCompletionCallback