建立新的裝置函式驅動程式

  • 發行項

在本文中，我們將說明如何使用Visual Studio開始撰寫新的裝置函式驅動程式。 裝置函式驅動程式與篩選驅動程式、軟體驅動程式和檔案系統驅動程式不同，我們會在其他文章中討論。 若要瞭解裝置函式驅動程式，以及它們與其他驅動程序類型有何不同，請參閱 什麼是驅動程式？、 選擇驅動程式型號，以及 裝置節點和裝置堆疊。

若要開始，請判斷您的裝置符合 裝置和驅動程序技術中所述的技術清單。 若要瞭解哪些驅動程式模型可供您的裝置使用，請參閱該特定技術的檔。 建議的驅動程式模型會因一種技術而異。 針對某些技術，文件建議使用使用者模式驅動程式架構 (UMDF) 或核心模式驅動程序架構 (KMDF) 。 針對其他技術，文件說明如何建立屬於驅動程式配對的迷你驅動程式。 Minidrivers 會依各種名稱進行，包括迷你埠和迷你類別。

判斷下列哪一個案例描述您的驅動程式模型建議，並遵循下列步驟：

案例 1：技術的文件建議 UMDF

  1. 啟動 Visual Studio。
  2. 在啟動對話框中選擇 [ 建立新專案 ]，或選取 [ 新增] | Visual Studio [檔案] 功能表中的 [專案]。
  3. 在 [ 建立新專案 ] 對話框的右窗格中，找出並選取 [ 使用者模式驅動程式] (UMDF V2) 。
  4. 選取 [下一步] 。
  5. 填寫 [項目名稱]、[ 位置] 和 [ 方案名稱] 方塊，然後選取 [ 建立]。 如需詳細資訊，請參閱 根據範本撰寫 UMDF 驅動程式。

    注意

    當您建立新的 UMDF 驅動程式時，您必須選取具有 32 個字元或更少字元的驅動程式名稱。 此長度限制定義於 wdfglobals.h 中。

  6. 此時，您有一個驅動程序專案，可實作大部分 UMDF 驅動程式所需的一般程式代碼。 現在，您可以提供裝置專屬的程序代碼。 請參閱技術的檔，以瞭解您需要實作的介面。

案例 2：技術的文件建議 KMDF

  1. 啟動 Visual Studio。
  2. 在啟動對話框中選擇 [ 建立新專案 ]，或選取 [ 新增] | Visual Studio [檔案] 功能表中的 [專案]。
  3. 在 [ 建立新專案 ] 對話框的右窗格中，找出並選取 [核心模式驅動程式] (KMDF) 。
  4. 選取 [下一步] 。
  5. 填寫 [項目名稱]、[ 位置] 和 [ 方案名稱] 方塊，然後選取 [ 建立]。 如需詳細資訊，請參閱 根據範本撰寫 KMDF 驅動程式。

    注意

    當您建立新的 KMDF 驅動程式時，您必須選取具有 32 個字元或更少字元的驅動程序名稱。 此長度限制定義於 wdfglobals.h 中。

  6. 此時，您有一個驅動程序專案，可實作大部分 KMDF 驅動程式所需的一般程式代碼。 現在，您可以提供裝置專屬的程序代碼。 請參閱技術的檔，以瞭解您需要實作的方法。

案例 3：技術的檔描述迷你驅動程式模型

如果您的裝置技術有迷你埠、迷你類別或其他一些迷你驅動程式模型，請檢查Visual Studio是否有特定模型的範本。

  1. 啟動 Visual Studio。
  2. 在啟動對話框中選擇 [ 建立新專案 ]，或選取 [ 新增] | Visual Studio [檔案] 功能表中的 [專案]。
  3. 在 [ 建立新專案 ] 對話框的右窗格中，流覽已安裝的範本清單，以尋找您需要寫入之驅動程式類型的範本。
  4. 如果您找到驅動程式類型的範本，請加以選取。
  5. 選取 [下一步] 。
  6. 填寫 [項目名稱]、[ 位置] 和 [ 方案名稱] 方塊，然後選取 [ 建立]。
  7. 如果您看到驅動程式精靈，請逐步執行精靈來建立驅動程序專案。
  8. 此時，您有一個驅動程序專案，可實作驅動程式所需的一般程序代碼。 現在，您可以提供裝置專屬的程序代碼。 請參閱技術的檔，以瞭解您需要實作的函式。

如果您的裝置技術有迷你驅動程式模型，而且您無法找到您類型迷你驅動程式的特定範本，Windows 驅動程式模型 (WDM) 範本最有可能是您起點。 如需指引，請參閱您的技術特定檔。 在少數情況下，您可以使用 KMDF 來撰寫迷你驅動程式，但通常起點是 WDM。

  1. 啟動 Visual Studio。
  2. 在啟動對話框中選擇 [ 建立新專案 ]，或選取 [ 新增] | Visual Studio [檔案] 功能表中的 [專案]。
  3. 在 [ 建立新專案 ] 對話框的右窗格中，找出並選取 [空白 WDM 驅動程式]。
  4. 選取 [下一步] 。
  5. 填寫 [項目名稱]、[ 位置] 和 [ 方案名稱] 方塊，然後選取 [ 建立]。
  6. 此時，您有空的 WDM 驅動程式專案。 在 [方案總管] 視窗中，以滑鼠右鍵按兩下您的驅動程式專案，然後選擇 [新增] |新增專案。
  7. 在 [ 新增專案 ] 對話框中，輸入.cpp檔案的名稱，然後選取 [ 新增]。

    注意

    如果您想要建立 .c 檔案，而不是.cpp檔案，請輸入擴展名為 .c 的名稱。

  8. 請參閱技術的檔，以瞭解您需要實作的函式。 當您實作及組織函式時，您可能會決定新增更多.cpp或 .c 檔案。