IWDFIoRequest::GetFileObject-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 GetFileObject--Methode ruft einen Zeiger auf die IWDFFile Schnittstelle ab, die einer E/A-Anforderung zugeordnet ist.
Syntax
void GetFileObject(
[out] IWDFFile **ppFileObject
);
Parameter
[out] ppFileObject
Ein Zeiger auf einen Puffer, der einen Zeiger auf die IWDFFile Schnittstelle für das Dateiobjekt empfängt. Beachten Sie, dass das Zurückgeben NULL- gültig ist.
Rückgabewert
Nichts
Bemerkungen
Wenn Ihr Treiber GetFileObject-aufruft, erhöht das Framework die Referenzanzahl auf der Schnittstelle. Ihr Treiber ist dafür verantwortlich, den Verweis freizugeben, wenn er mit dem Schnittstellenzeiger fertig ist. Verwenden Sie dazu entweder einen intelligenten Zeiger, der die Verweisanzahl automatisch erhöht, wenn das Objekt den Kontext verlassen wird, oder rufen Sie Release auf der Schnittstelle auf, wenn sie damit fertig ist.
Beispiele
Das folgende Codebeispiel stammt aus dem WpdMultiTransportDriver-Beispiel im WDK. Im Beispiel wird ein intelligenter Zeiger auf eine IWDFFile--Schnittstelle deklariert, GetFileObject-aufgerufen und anschließend RetrieveContext- für das Dateiobjekt aufgerufen.
CComPtr<IWDFFile> pFileObject;
...
// Get the Context map for this client
pRequest->GetFileObject(&pFileObject);
if (pFileObject != NULL)
{
hr = pFileObject->RetrieveContext((void**)&pClientContextMap);
CHECK_HR(hr, "Failed to get Contextmap from WDF File Object");
}
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 |