在本文中,我們會說明如何使用Visual Studio開始撰寫新的裝置函式驅動程式。 裝置功能驅動程式與篩選驅動程式、軟體驅動程式和文件系統驅動程式不同,我們在其他文章中涵蓋這些驅動程式。 若要瞭解裝置功能驅動程式,以及它們與其他驅動程序類型有何不同,請參閱 什麼是驅動程式?、 選擇驅動程式模型,以及 裝置節點和裝置堆疊。
若要開始,請判斷您的裝置符合 裝置和驅動程序技術中所述的技術清單。 若要瞭解哪些驅動程式型號可供您的裝置使用,請參閱該特定技術的檔。 建議的驅動程式模型會因一項技術而異。 對於某些技術,文件建議使用使用者模式驅動程序架構 (UMDF) 或核心模式驅動程序架構 (KMDF)。 對於其他技術,文件說明如何建立屬於驅動程式配對的迷你驅動程式。 迷你驅動程式會依各種名稱執行,包括迷你埠和迷你類別。
判斷下列哪一個案例描述您的驅動程式模型建議,並遵循下列步驟:
案例 1:技術的文件建議 UMDF
- 啟動 Visual Studio。
- 在啟動對話框中選擇 [建立新專案 ],或選取 [ 新增] | Visual Studio [檔案 ] 功能表中的專案。
- 在 [建立新專案] 對話框的右窗格中,找出並選取 [使用者模式驅動程式] [UMDF V2]。
- 選取 下一步。
- 填入 [項目名稱]、[ 位置] 和 [ 方案名稱] 方塊,然後選取 [ 建立]。 如需詳細資訊,請參閱 根據範本撰寫 UMDF 驅動程式。
備註
當您建立新的 UMDF 驅動程式時,您必須選取具有 32 個字元或更少字元的驅動程式名稱。 此長度限制定義於 wdfglobals.h 中。
- 此時,您有一個驅動程序專案,可實作大部分 UMDF 驅動程式所需的一般程式代碼。 現在,您可以提供裝置特有的程序代碼。 請參閱技術的檔,以瞭解您需要實作的介面。
案例 2:技術的文件建議 KMDF
- 啟動 Visual Studio。
- 在啟動對話框中選擇 [建立新專案 ],或選取 [ 新增] | Visual Studio [檔案 ] 功能表中的專案。
- 在 [ 建立新專案 ] 對話框的右窗格中,找出並選取 核心模式驅動程式 (KMDF) 。
- 選取 下一步。
- 填入 [項目名稱]、[ 位置] 和 [ 方案名稱] 方塊,然後選取 [ 建立]。 如需詳細資訊,請參閱 根據範本撰寫 KMDF 驅動程式。
備註
當您建立新的 KMDF 驅動程式時,您必須選取具有 32 個字元或更少字元的驅動程序名稱。 此長度限制定義於 wdfglobals.h 中。
- 此時,您有一個驅動程序專案,可實作大部分 KMDF 驅動程式所需的一般程式代碼。 現在,您可以提供裝置特有的程序代碼。 請參閱技術的檔,以瞭解您需要實作的方法。
案例 3:技術的文件說明迷你驅動程式模型
如果您的裝置技術具有迷你埠、迷你類別或其他一些迷你驅動程式模型,請檢查Visual Studio是否有模型的特定範本。
- 啟動 Visual Studio。
- 在啟動對話框中選擇 [建立新專案 ],或選取 [ 新增] | Visual Studio [檔案 ] 功能表中的專案。
- 在 [ 建立新專案 ] 對話框的右窗格中,流覽已安裝的範本清單,以尋找您需要撰寫之驅動程式類型的範本。
- 如果您找到驅動程式類型的範本,請加以選取。
- 選取 下一步。
- 填入 [項目名稱]、[ 位置] 和 [ 方案名稱] 方塊,然後選取 [ 建立]。
- 如果您看到驅動程式精靈,請逐步執行精靈來建立驅動程序專案。
- 此時,您有一個驅動程序專案,可實作驅動程式所需的一般程序代碼。 現在,您可以提供裝置特有的程序代碼。 請參閱技術的檔,以瞭解您需要實作的函式。
如果您的裝置技術具有迷你驅動程式模型,而且您找不到迷你驅動程序類型的特定範本,則 Windows 驅動程式模型 (WDM) 範本很可能是您的起點。 如需指引,請參閱您的技術特定檔。 在罕見的情況下,您可以使用 KMDF 來撰寫迷你驅動程式,但起點通常是 WDM。
- 啟動 Visual Studio。
- 在啟動對話方塊中選擇 [建立新專案],或從 Visual Studio 的 [檔案] 功能表中選取 [新增 | 專案]。
- 在 [ 建立新專案 ] 對話框的右窗格中,找出並選取 [空白 WDM 驅動程式]。
- 選取 下一步。
- 填入 [項目名稱]、[ 位置] 和 [ 方案名稱] 方塊,然後選取 [ 建立]。
- 此時,您有一個空白的 WDM 驅動程式專案。 在 [方案總管] 視窗中,以滑鼠右鍵按兩下您的驅動程式專案,然後選擇 [ 新增] |新增專案。
- 在 [ 新增專案 ] 對話框中,輸入.cpp檔案的名稱,然後選取 [ 新增]。
備註
如果您想要建立 .c 檔案,而不是.cpp檔案,請輸入擴展名為 .c 的名稱。
- 請參閱您所使用技術的文件,以瞭解您需要實作的功能。 當您實作及組織函式時,您可能會決定新增更多.cpp或 .c 檔案。