Instalowanie urządzenia Bluetooth

Ważne

Ten artykuł jest przeznaczony dla programistów. Jeśli jesteś klientem, u którego występują problemy z instalacją urządzenia Bluetooth, zobacz Parowanie urządzenia Bluetooth w systemie Windows

Istnieją dwa typy instalacji sterowników profilów Bluetooth:

• instalacja po stronie klienta dla urządzeń zdalnych, gdzie urządzenie zdalne ogłasza swoje usługi, a komputer się do niego łączy. Przykłady to: myszy, klawiatury i drukarki.
• Instalacja po stronie serwerowej, w której komputer udostępnia usługi, a urządzenia zdalne mogą się z nim łączyć, aby korzystać z tych usług. Na przykład dostawca może utworzyć instalację po stronie serwera, aby umożliwić urządzeniu przenośnemu drukowanie na drukarce dołączonej do komputera.

Te dwa typy instalacji wymagają różnych procedur instalacji.

Instalowanie sterownika profilu po stronie klienta

Użytkownik, który chce użyć urządzenia z funkcją Bluetooth, przenosi urządzenie w zasięgu komputera i inicjuje połączenie z komputera z urządzeniem zdalnym, używając następującej sekwencji instalacji sterownika profilu po stronie klienta.

1. Wybierz pozycję Dodaj urządzenie Bluetooth w Panelu sterowania, aby znaleźć wszystkie urządzenia w zasięgu komputera.
2. Wybierz urządzenie, za pomocą którego chcesz sparować.
3. Połącz urządzenie z lokalnym radiem, które może lub nie wymaga wymiany numeru PIN.
4. Lokalne radio wystawia zapytanie protokołu SDP (Service Discovery Protocol) w celu zidentyfikowania usług obsługiwanych na urządzeniu zdalnym.
5. Kreator znajdowania nowego sprzętu wyszukuje odpowiednie sterowniki na lokalnym dysku twardym i w usłudze Windows Update.
6. Jeśli kreator znaleziono nowy sprzęt nie znajdzie odpowiedniego sterownika dla urządzenia, monituje użytkownika o wstawienie nośnika instalacyjnego sterownika profilu zawierającego plik informacji o konfiguracji urządzenia sterownika profilu (plik INF).

Instalowanie sterownika profilu po stronie serwera

Stos sterowników Bluetooth obsługuje identyfikatory GUID usługi zdefiniowane przez Bluetooth SIG oraz niestandardowe identyfikatory GUID niezdefiniowane przez Bluetooth SIG.

Uwaga

Narzędzie guidgen.exe dostarczone do zestawu Microsoft Windows SDK może służyć do tworzenia niestandardowych GUID-ów.

Aby uwidocznić funkcje komputera, z których mogą korzystać zdalne urządzenia Bluetooth, należy napisać aplikację instalacji w trybie użytkownika.

Aplikacja instalacji musi komunikować się ze stosem sterowników Bluetooth, aby utworzyć identyfikator GUID usługi, aby umożliwić uwidocznienie funkcji. Dostawcy określają identyfikator GUID usługi w aplikacji oraz w pliku INF instalacji ich urządzenia.

Aplikacja instalacyjna musi wywołać interfejs API w trybie użytkownika BluetoothSetLocalServiceInfo. Aby aplikacja mogła wywołać ten interfejs API, aplikacja musi mieć uprawnienia zabezpieczeń SE_LOAD_DRIVER_NAME. W poniższym przykładzie kodu pokazano, jak uzyskać to uprawnienie. Uwaga, że w przykładzie nie pokazano obsługi błędów.

HANDLE procToken;
LUID luid;
TOKEN_PRIVILEGES tp;

OpenProcessToken(GetCurrentProcess(), TOKEN_ADJUST_PRIVILEGES | TOKEN_QUERY, &procToken);

LookupPrivilegeValue(NULL, SE_LOAD_DRIVER_NAME, &luid);

Tp.PrivilegeCount = 1;
Tp.privileges[0].Luid = luid;
Tp.Privileges[0].Attributes = SE_PRIVILEGE_ENABLED;

AdjustTokenPrivileges(procToken, FALSE, &tp, sizeof(TOKEN_PRIVILEGES), (PTOKEN_PRIVILEGES) NULL, (PDWORD)NULL)

Plik INF sterownika profilu

Plik INF sterownika profilu zawiera informacje o urządzeniu Bluetooth na potrzeby instalacji po stronie klienta. W przypadku instalacji po stronie serwera plik INF określa identyfikator urządzenia, który odpowiada identyfikatorowi GUID usługi utworzonemu przez aplikację instalacji. Wszystkie urządzenia Bluetooth są członkami klasy Bluetooth. Instalator klasy Bluetooth (Bthci.dll) ułatwia instalowanie sterowników profilów.

Aby uzyskać więcej informacji na temat tworzenia i rozpowszechniania plików INF oraz instalowania sterowników, zobacz Creating an INF File and INF File Sections and Directives.

Identyfikatory Plug and Play

Stos sterowników Bluetooth generuje identyfikatory sprzętu zgodnie z następującymi szablonami:

• BTHENUM\{ ServiceGUID}_VID& nnnnnnnn
• BTHENUM\{ ServiceGUID}_VID& nnnnnnnn_PID& nnnn
• BTHENUM\{ ServiceGUID}_LOCALMFG& nnnn

Stos sterowników Bluetooth generuje zgodne identyfikatory zgodnie z następującym szablonem:

• BTHENUM\{ ServiceGUID}

ServiceGUID jest 16-bitowym identyfikatorem GUID rozwiniętym w 128-bitowy identyfikator GUID, zgodnie ze specyfikacją Bluetooth. Na przykład {00001124-0000-1000-8000-00805F9B34FB} odpowiada urządzeniu HID.

• Osiem cyfr po VID& odpowiada kodowi identyfikatora dostawcy.
• Cztery cyfry po PID& odpowiadają kodowi identyfikatora produktu.
• Cztery cyfry następujące LOCALMFG& odpowiadają producentowi lokalnego radia Bluetooth.
• Tagi VID/PID i LOCALMFG są niezależne od siebie.

Najbardziej ogólny identyfikator urządzenia to sam w sobie ServiceGUID. Na przykład:

BTHENUM\{00001124-0000-1000-8000-00805F9B34FB}

Stos sterowników Bluetooth może być ograniczony do ładowania sterownika profilu oraz do działania oprogramowania tylko na określonej wersji urządzenia zdalnego, przy użyciu identyfikatorów Plug and Play zarówno w urządzeniu zdalnym, jak i w pliku INF. Stos sterowników Bluetooth generuje parę VID/PID tylko wtedy, gdy urządzenie publikuje identyfikator Plug and Play, który stos może wykryć przy użyciu protokołu SDP. Na przykład:

BTHENUM\{00001124-0000-1000-8000-00805F9B34FB}_VID& nnnnnnnn_PID& nnnn

Stos sterowników Bluetooth może być ograniczony do ładowania sterownika profilu i oprogramowania do uruchamiania tylko na określonym lokalnym radiu Bluetooth, określając tag LOCALMFG w identyfikatorze urządzenia w pliku INF. Na przykład:

BTHENUM\{00001124-0000-1000-8000-00805F9B34FB}_LOCALMFG& nnnn