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. Es werden keine neuen Features zu UMDF 1 hinzugefügt, und es gibt eingeschränkte Unterstützung für UMDF 1 für neuere Versionen von Windows 10. 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.
Bemerkungen
Da der Kontext keine COM-Schnittstelle (Component Object Model) ist, darf der Treiber den Kontext nicht als solche behandeln. Beispielsweise kann der Treiber die AddRef--Methode im Kontext nicht 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 |
| Mindest-UMDF-Version | 1.5 |
| Header- | wudfddi.h (include Wudfddi.h) |
| DLL- | WUDFx.dll |