Framework 檔案物件

警告

UMDF 2 是最新版的 UMDF，並取代 UMDF 1。 所有新的 UMDF 驅動程式都應該使用 UMDF 2 撰寫。 未將新功能新增至 UMDF 1，且較新版本的WINDOWS 10上，UMDF 1 的支援有限。 通用 Windows 驅動程式必須使用 UMDF 2。

封存的 UMDF 1 範例可在Windows 11 22H2 - 2022 年 5 月驅動程式範例更新中找到。

如需詳細資訊，請參閱使用 UMDF 消費者入門。

架構檔案物件會由 IWDFFile 介面向驅動程式公開。 這是已開啟裝置的架構標記法。 當應用程式透過 Microsoft Win32 CreateFile 函式開啟裝置時，架構會建立檔案物件來代表開啟的裝置實例。 因此，架構檔案物件在概念上相當於從應用程式呼叫 CreateFile傳回的 Win32 控制碼。 架構可以建立與單一裝置相關聯的多個檔案物件。 每個成功呼叫 CreateFile時都會建立每個檔案物件。 所有 I/O 作業，例如讀取和寫入，都是以特定檔案物件實例為目標。

注意 傳遞至 UMDF 驅動程式的所有要求都會與檔案物件相關聯。 不過，傳遞至 WDM 和 KMDF 驅動程式的要求有時不會與檔案物件相關聯。

UMDF 驅動程式可以呼叫 IWDFIoRequest：：GetFileObject 方法，以取得與要求相關聯的檔案物件。

當您的驅動程式呼叫 GetFileObject 時，架構會遞增介面上的參考計數。 驅動程式負責在介面指標完成時釋放參考。 若要這樣做，請使用智慧型指標，在物件離開內容時自動遞減參考計數，或在介面上呼叫 Release 。 如需示範如何使用智慧型指標的程式碼範例，請參閱 GetFileObject。