Erstellen eines Dateiobjekts zum Verarbeiten von E/A

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.

Die archivierten UMDF 1-Beispiele finden Sie im Windows 11, Version 22H2 – Mai 2022 Treiberbeispiele Update.

Weitere Informationen finden Sie unter Erste Schritte mit UMDF.

Wenn eine Anwendung ein Dateihandle öffnet, erstellt der E/A-Manager ein Dateiobjekt. Das Framework erstellt wiederum ein Frameworkdateiobjekt, das das Dateiobjekt des E/A-Managers darstellt.

Sofern der Treiber die UmdfFileObjectPolicy-Direktive nicht auf AllowNullAndUnknownFileObjects festlegt, erfordert UMDF, dass jede E/A-Anforderung einem Dateiobjekt zugeordnet ist. Weitere Informationen zu dieser Direktive finden Sie unter Angeben von WDF-Direktiven in INF-Dateien.

Wenn Ihr UMDF-Treiber E/A unabhängig von der Anwendung an den nächsten Treiber im Stapel sendet (z. B. während der Geräteinitialisierung oder um Benachrichtigungen über Geräteereignisse zu erhalten), muss der Treiber ein eigenes Dateiobjekt erstellen, das der Anforderung zugeordnet werden kann.

In den folgenden Abschnitten werden die Unterschiede zwischen vom Treiber erstellten Dateiobjekten und von der Anwendung erstellten Dateiobjekten sowie die Erstellung und Verwendung eines Dateiobjekts durch den Treiber beschrieben.