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. Es werden keine neuen Features zu UMDF 1 hinzugefügt, und es gibt eingeschränkte Unterstützung für UMDF 1 für neuere Versionen von Windows 10. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF-.]
Die CreateWdfFile--Methode erstellt ein Dateiobjekt für einen zu verwendenden Treiber.
Syntax
HRESULT CreateWdfFile(
[in, optional] LPCWSTR pcwszFileName,
[out] IWDFDriverCreatedFile **ppFile
);
Parameter
[in, optional] pcwszFileName
Ein Zeiger auf eine NULL--terminated string that contains the name of the file to create a file object from. 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.
Bemerkungen
Informationen dazu, wann ein UMDF-Treiber CreateWdfFile- zum Behandeln von E/A verwendet, finden Sie unter Erstellen eines Dateiobjekts zum Behandeln von E/A-.
Informationen dazu, wann ein UMDF-Treiber CreateWdfFile- verwenden kann, um ein Ungleichgewicht der Erstellung und Schließung 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 |
| Mindest-UMDF-Version | 1.5 |
| Header- | wudfddi.h (include Wudfddi.h) |
| DLL- | WUDFx.dll |