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. 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 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 die Rückgabe von NULL gültig ist.
Rückgabewert
Keine
Bemerkungen
Wenn Ihr Treiber GetFileObject aufruft, erhöht das Framework die Verweisanzahl 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 dekrementiert, wenn das Objekt aus dem Kontext ausgeht, oder rufen Sie Release auf der Schnittstelle auf, wenn dies abgeschlossen ist.
Beispiele
Das folgende Codebeispiel stammt aus dem WpdMultiTransportDriver-Beispiel im WDK. Das Beispiel deklariert einen intelligenten Zeiger auf eine IWDFFile-Schnittstelle , ruft GetFileObject auf und ruft dann RetrieveContext für das Dateiobjekt auf.
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 |
| UMDF-Mindestversion | 1.5 |
| Kopfzeile | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |