Objekt souboru rámce

Výstraha

UMDF 2 je nejnovější verze UMDF a nahrazuje UMDF 1. Všechny nové ovladače UMDF by měly být zapsány pomocí UMDF 2. Do UMDF 1 se nepřidávají žádné nové funkce a v novějších verzích Windows 10 je omezená podpora UMDF 1. Univerzální ovladače systému Windows musí používat UMDF 2.

Archivované ukázky UMDF 1 najdete v aktualizaci ovladačů pro Windows 11, verze 22H2 z května 2022 – .

Další informace najdete v tématu Začínáme s UMDF.

Objekt souboru rozhraní je vystaven ovladačům prostřednictvím rozhraní IWDFFile. Jedná se o architekturu znázornění otevřeného zařízení. Když aplikace otevře zařízení prostřednictvím funkce Microsoft Win32 CreateFile , architektura vytvoří objekt souboru představující otevřenou instanci zařízení. Proto je objekt souboru architektury koncepčně ekvivalentní popisovač Win32, který je vrácen z volání aplikace CreateFile. Architektura může vytvořit více objektů souborů přidružených k jednomu zařízení. Každý objekt souboru se vytvoří pro každé úspěšné volání CreateFile. Všechny vstupně-výstupní operace, jako jsou čtení a zápisy, cílí na konkrétní instanci objektu souboru.

Poznámka Všechny požadavky předané ovladačům UMDF jsou přidruženy k objektům souborů. Požadavky však, které jsou předávány ovladačům WDM a KMDF, nejsou někdy přidruženy k objektům souboru.

Ovladač UMDF může volat metodu IWDFIoRequest::GetFileObject k získání objektu souboru přidruženého k požadavku.

Když ovladač volá GetFileObject, architektura zvýší počet odkazů na rozhraní. Řidič je zodpovědný za uvolnění reference, když dokončí práci s ukazatelem rozhraní. Uděláte to tak, že buď použijete inteligentní ukazatel, který automaticky sníží počet odkazů, když objekt vyjde z kontextu, nebo zavoláte Release na rozhraní, až s ním skončíte. Příklad kódu, který ukazuje, jak použít inteligentní ukazatel, viz GetFileObject.