IWDFIoTarget::GetTargetFile-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 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 GetTargetFile-Methode ruft das Frameworkdateiobjekt ab, das dem E/A-Zielobjekt zugeordnet ist.

Syntax

void GetTargetFile(
  [out] IWDFFile **ppWdfFile
);

Parameter

[out] ppWdfFile

Zeiger auf einen Puffer, der einen Zeiger auf die IWDFFile-Schnittstelle für das Dateiobjekt des E/A-Ziels empfängt.

Rückgabewert

Keine

Bemerkungen

Wenn ein Frameworkdateiobjekt einem E/A-Zielobjekt zugeordnet ist, enthält das Framework das Dateiobjekt mit E/A-Anforderungen, die der Treiber an das E/A-Zielobjekt sendet.

Wenn ein Treiber eine E/A-Anforderung formatiert, ermöglicht ein E/A-Zielobjekt dem Treiber, entweder dieselbe Datei zu verwenden, mit der die Anforderung gestartet wurde, oder eine neue Datei.

Das Standard-E/A-Ziel verfügt über kein Dateiobjekt, sodass bei einem Aufruf von GetTargetFile für das E/A-Standardziel NULL abgerufen wird.

Weitere Informationen zu E/A-Zielen finden Sie unter Verwenden von E/A-Zielen in UMDF.

Beispiele

Ein Codebeispiel für die Verwendung der GetTargetFile-Methode finden Sie unter IWDFIoTarget::FormatRequestForWrite.

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