條碼掃描器驅動程式範例
條碼掃描器驅動程式範例示範如何建立條碼掃描器的通用驅動程式,並用來作為建立新條形碼掃描器驅動程式的範本。 此範例會使用使用者模式驅動程序架構 (UMDF) 2.0,並示範基本功能,例如宣告裝置以進行獨佔存取。 範例驅動程式可以在 x86、amd64 和 Arm 平臺上編譯和部署。 如需通用驅動程式的詳細資訊,請移至 使用通用 INF 檔案。
需求
Windows 10
Microsoft Visual Studio (任何版本)
也需要 Windows 軟體開發工具包 (SDK) 10,但這會安裝為 Visual Studio Microsoft的一部分。
範例驅動程式不需要任何條碼掃描器硬體才能運作,因為它會在軟體裝置上運作。 如果您有想要搭配範例使用的硬體裝置,您仍然可以將裝置硬體識別碼新增至 INF 檔案來使用驅動程式。
下載並擷取範例
下載 Windows-driver-samples-master.zip。 此檔案包含所有 Windows 驅動程式套件 (WDK) 範例。
將Windows-driver-samples-master.zip擷 取 至您在開發電腦上所選的位置。 本文其餘部分將稱為
<sample_root>
此位置。
在 Visual Studio 中開啟驅動程式解決方案
在 Windows 檔案總管中,流覽至
<sample_root>\pos\drivers\barcodescanner
資料夾。按兩下方案檔, BarcodeScanner.sln 以Visual Studio 開啟方案。
專案 zip 檔案已從因特網下載,因此當您開啟方案時,可能會看到安全性警告。 如果您這樣做,請選取 [ 確定 ] 以完成載入專案。
在 Visual Studio 中,找出 方案總管。 如果尚未開啟,請從 [檢視] 功能選取 [方案總管]。 在 方案總管 中,您可以看到專案及其包含的來源檔案。
使用 Visual Studio 建置範例
從 Visual Studio 中的 [ 標準 ] 工具列,選取 符合您操作系統平臺的解決方案 平臺。 例如,如果您使用 64 位版本的 Windows,請選取 x64。 如果以 Arm 平台為目標,您必須使用組態管理員將 Arm 新增至目標清單。
從 [組建] 功能表中選取 [組建解決方案]。
安裝驅動程式
建置時,驅動程式會使用測試認證簽署。 若要安裝要測試的驅動程式,您必須變更開機設定,以允許使用測試憑證簽署的驅動程式載入。 若要變更設定,請開啟提升許可權的命令提示字元,然後輸入命令:
bcdedit.exe /set TESTSIGNING on
將電腦重新開機。 如果先前已啟用測試簽署,就不需要重新啟動。
從提升許可權的命令提示字元中,流覽至專案建置所在的資料夾。 如果您已建立 x64 偵錯組建, 此資料夾會是
<project_root>\x64\Debug\SampleBarcodeScannerDrv
。在該資料夾中,您會看到下列檔案:
檔案 說明 SampleBarcodeScannerDrv.dll 驅動程式檔案。 SampleBarcodeScannerDrv.inf INF 檔案,其中包含安裝驅動程式所需的資訊。 samplebarcodescannerdrv.cat 已簽署的類別目錄檔案,可作為整個套件的簽章。 識別符合您 OS 和驅動程式平臺的 Device Console 公用程式 (devcon.exe) 路徑。 x64 版本的預設位置是
C:\Program Files (x86)\Windows Kits\10\Tools\x64
。輸入下列命令,將 取代
<devcon\_path>
為您在上一個步驟中找到之devcon.exe檔案的路徑。<devcon_path>\devcon.exe install SampleBarcodeScannerDrv.inf Root\SampleBarcodeScannerDrv
您會看到 Windows 安全性 對話框,通知您無法驗證驅動程式的發行者。 這是因為驅動程式已使用測試憑證簽署。 選取 [ 無論如何安裝此驅動程序軟體]。 在片刻中,您會看到驅動程式已正確安裝。
如果 Device Console 公用程式無法安裝驅動程式,請確認您使用的是符合您目前 OS 平台和驅動程式平台的驅動程式。
在 裝置管理員 中檢視裝置
開啟裝置管理員。 這可以完成許多方式,但如果您仍在命令提示字元中,請輸入
devmgmt
。在 [裝置管理員] 中,從 [檢視] 功能表依類型選擇 [裝置]。
您的裝置列在 [範例 ] 節點底下。