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 |