IWDFIoTarget::GetTargetFile-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 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 |