Share via

IWDFIoRequest::GetFileObject-Methode (wudfddi.h)

  • Artikel

[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

Weitere Informationen

IWDFFile

IWDFIoRequest