IWDFObject::RetrieveContext-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 RetrieveContext-Methode ruft einen Kontext ab, der zuvor über die IWDFObject::AssignContext-Methode registriert wurde.

Syntax

HRESULT RetrieveContext(
  [out] void **ppvContext
);

Parameter

[out] ppvContext

Ein Zeiger auf einen Puffer, der einen Zeiger auf den zuvor registrierten Kontext empfängt.

Rückgabewert

RetrieveContext gibt S_OK zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Methode einen der Fehlercodes zurück, die in Winerror.h definiert sind.

Hinweise

Da der Kontext keine COM-Schnittstelle (Component Object Model) ist, darf der Treiber den Kontext nicht als solchen behandeln. Beispielsweise kann der Treiber die AddRef-Methode nicht im Kontext aufrufen.

Beispiele

Ein Codebeispiel für die Verwendung der RetrieveContext-Methode finden Sie unter IWDFIoQueue::GetDevice.

Anforderungen

Anforderung	Wert
Ende des Supports	In UMDF 2.0 und höher nicht verfügbar.
Zielplattform	Desktop
UMDF-Mindestversion	1.5
Kopfzeile	wudfddi.h (include Wudfddi.h)
DLL	WUDFx.dll

Weitere Informationen

IWDFIoQueue::GetDevice

IWDFObject

IWDFObject::AssignContext