條碼掃描器驅動程式範例示範如何建立條碼掃描器的通用驅動程式。 其用途是用來作為建立新條碼掃描器驅動程式的範本。 此範例使用 User-Mode Driver Framework(UMDF) 2.0,並示範基本功能,例如聲明裝置以進行獨佔存取。 範例驅動程式可以在 x86、amd64 和 Arm 平臺上編譯和部署。 如需通用驅動程式的詳細資訊,請移至 使用通用 INF 檔案。
需求
Windows 10
Microsoft Visual Studio (任何版本)
也需要 Windows 軟體開發工具套件(SDK)10,但此套件是 Microsoft Visual Studio 的一部分,會隨之安裝。
範例驅動程式不需要任何條碼掃描器硬體才能運作,因為它會在軟體裝置上運作。 如果您有想要搭配範例使用的硬體裝置,您仍然可以將裝置硬體識別碼新增至 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 開啟方案。
在 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 已簽署的目錄檔案,為整個套件的簽名。 找出符合作業系統和驅動程式平台的 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 公用程式無法安裝驅動程式,請確認您使用的是符合您目前作系統平台和驅動程式平台的驅動程式。
在設備管理器中檢視裝置
開啟設備管理員。 有很多方法可以做到這件事,但如果您仍在命令提示字元中,請輸入
devmgmt
。在 [裝置管理員] 中,從 [檢視] 功能表中選擇 [依類型裝置]。
您的裝置列在 [ 範例 ] 節點底下。