IWDFDevice::CreateWdfFile-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 CreateWdfFile-Methode erstellt ein Dateiobjekt, das von einem Treiber verwendet werden kann.

Syntax

HRESULT CreateWdfFile(
  [in, optional] LPCWSTR               pcwszFileName,
  [out]          IWDFDriverCreatedFile **ppFile
);

Parameter

[in, optional] pcwszFileName

Ein Zeiger auf eine NULL-beendete Zeichenfolge, die den Namen der Datei enthält, aus der ein Dateiobjekt erstellt werden soll. Dieser Parameter ist optional. Der Treiber kann NULL übergeben, wenn der Treiber das Dateiobjekt nicht aus einem Dateinamen erstellen muss. Wenn der Treiber einen Namen angeben muss, darf die vom Treiber übergebene Zeichenfolge keine Pfadtrennzeichen ("/" oder "\") enthalten.

[out] ppFile

Ein Zeiger auf einen Puffer, der einen Zeiger auf die IWDFDriverCreatedFile-Schnittstelle für das vom Treiber erstellte Dateiobjekt empfängt.

Rückgabewert

CreateWdfFile gibt S_OK zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Methode einen der Fehlercodes zurück, die in Winerror.h definiert sind.

Hinweise

Informationen dazu, wann ein UMDF-Treiber CreateWdfFile zum Verarbeiten von E/A verwendet, finden Sie unter Erstellen eines Dateiobjekts zum Verarbeiten von E/A.

Informationen dazu, wann ein UMDF-Treiber CreateWdfFile verwenden könnte, um ein Ungleichgewicht beim Erstellen und Schließen von Benachrichtigungen an einen Treiber zu verhindern, finden Sie unter Verhindern eines Ungleichgewichts beim Erstellen und Schließen von Benachrichtigungen an einen Treiber.

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

IWDFDevice

IWDFDriverCreatedFile