架構程式庫版本控制

  • 發行項

在本主題中，您將瞭解 Kernel-Mode Driver Framework (KMDF) 程式庫的檔案名命名慣例，以及 User-Mode Driver Framework (UMDF) 程式庫。

KMDF

主要版本號碼和次要版本號碼會指派給 KMDF 程式庫的每個版本。 程式庫的檔案名包含主要版本號碼。 檔案名的格式為：

Wdf<MajorVersionNumber>000.sys

主要版本號碼使用兩個字元。 例如，程式庫 1.0 版的檔案名 Wdf01000.sys。 版本 1.9、1.11 等等也會命名 為Wdf01000.sys，而每個新次要版本的程式庫檔案都會覆寫舊版的檔案。

如果您使用比系統上架構版本更新的 KMDF 程式庫版本來建置驅動程式，則必須更新後者。 如需更新架構程式庫的詳細資訊，請參閱 可轉散發架構元件。

(請注意，架構共同安裝程式的檔案名同時包含主要和次要版本號碼。如需共同安裝程式檔案名的詳細資訊，請參閱 使用 KMDF Co-installer.)

當您建置驅動程式時，MSBuild 公用程式會連結驅動程式與存根檔案，其中包含 MSBuild 公用程式所使用的程式庫版本號碼。 當作業系統載入驅動程式時，架構的載入器會檢查驅動程式存根中的版本資訊，以判斷驅動程式是否會使用系統上的架構程式庫版本執行。

若要判斷驅動程式執行所在的程式庫版本，驅動程式可以呼叫 WdfDriverIsVersionAvailable 或 WdfDriverRetrieveVersionString。

WDF 可讓您使用與驅動程式執行版本不同的 Windows 來建置驅動程式。 如需詳細資訊，請參閱 建置適用于多個 Windows 版本的 WDF 驅動程式。

如需 KMDF 程式庫發行歷程記錄的相關資訊，請參閱 KMDF 版本歷程記錄。

UMDF

如同 KMDF，UMDF 程式庫的主要版本號碼會使用兩個字元。 不過，主要版本號碼只會出現在 UMDF 程式庫檔案名中，從 UMDF 2.0 版開始。

針對 UMDF 2.0 版，UMDF 程式庫的檔案名 Wudfx02000.dll。

針對 UMDF 第 1 版。x，UMDF 程式庫的檔案名 Wudfx.dll。

如需 KMDF 程式庫發行歷程記錄的相關資訊，請參閱 UMDF 版本歷程記錄。