windows-蓝牙驱动开发-蓝牙软件无线电开关函数原型

注意:从 Windows 8.1 开始,供应商不再需要在软件 DLL 中实现无线电开/关功能(对于蓝牙 4.0 无线电),因为操作系统现在可处理此功能。 即使存在,Windows 8.1 也会忽略任何此类 DLL。

对于 Windows 8,蓝牙无线电必须支持开/关软件功能。 为了让供应商获得更大的灵活性,蓝牙媒体无线电管理器支持插件,以允许用户公开此功能。

若要提供此 DLL 插件,必须完成两项操作。

必须创作 DLL,以导出正确的函数。必须在计算机上注册 DLL。 DLL 负责保留无线电状态,包括跨系统重启 DLL 必须导出两个函数:

BluetoothEnableRadio:无线电支持 DLL 会实现 BluetoothEnableRadio,使 Windows 能够打开或关闭无线电电源。

复制代码
DWORD WINAPI BluetoothEnableRadio(
   BOOL fEnable
);

fEnable:设置为 TRUE 可打开无线电电源。 设置为 FALSE 可关闭无线电电源。

返回值:如果当前状态更改为 fEnable 的状态,则返回 ERROR_SUCCESS。 否则,如果未更改当前状态,则返回 WIN32 错误代码。

IsBluetoothRadioEnabled:无线电支持 DLL 会实现 IsBluetoothRadioEnabled,使 Windows 能够确定无线电电源是否打开或关闭。

复制代码
DWORD WINAPI IsBluetoothRadioEnabled(
   BOOL* pfEnabled
);

pfEnabled:指向缓冲区的指针,描述无线电电源是打开还是关闭。

返回值:如果获取了当前状态,则返回 ERROR_SUCCESS。 pfEnabled 指向的值现在包含状态。 (true 或 false)。 否则,如果未获取当前状态,则返回 WIN32 错误代码。 pfEnabled 指向的值未定义,不应使用

DLL 注册

若要在菜单和控制面板小程序中启用软件无线电开关控件,必须注册此支持 DLL。 将以下注册表值设置为相关 DLL 的完整路径(可能包括环境变量)。

键:HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\BTHPORT\Parameters\Radio Support

值名称:"SupportDLL"

值数据:(路径)

示例:

HKEY_LOCAL_MACHINE\\SYSTEM\\CurrentControlSet\\Services\\BTHPORT\\Parameters\\Radio Support

"SupportDLL"="C:\Program Files\Fabrikam\BthSupport.dll"

需要在安全位置(如 C:\Program Files\Fabrikam)安装 DLL。

要求和建议

虽然这种设计允许灵活地控制硬件,但要求关闭状态不会导致无线电的传输/接收。 此外,建议关闭无线电电源以使其进入最低功率状态,以节省能源,并将其从总线中移除,以允许卸载蓝牙堆栈。

BluetoothEnableRadio 只能在发生无线电状态更改后返回结果。 此外,由于此 DLL 扩展旨在 Windows 内部提供统一无线电/关闭基础结构,因此应为 Windows 组件保留 DLL 的使用。 DLL 负责确保在以下情况下返回正确的结果:非 Windows 组件也使用 DLL,或者实现了一个硬件开关,该开关可以在蓝牙媒体无线电管理器的上下文外关闭无线电(例如,硬连接开关以关闭无线电)。

Windows 8 无线电管理要求 DLL 在本地服务帐户上下文中执行其指令。 在此上下文中,DLL 将在本地计算机上具有最低权限,这通常小于普通用户上下文的特权。

无线电支持 DLL 应执行适当的检查,以确保在执行任何操作之前存在相应的硬件。 如果在系统上找不到相应的硬件,无线电支持 DLL 应返回相应的错误代码。

蓝牙软件无线电示例源

注册表文件

Windows 注册表编辑器版本 5.00

HKEY_LOCAL_MACHINE\\SYSTEM\\CurrentControlSet\\Services\\BthServ

HKEY_LOCAL_MACHINE\\SYSTEM\\CurrentControlSet\\Services\\BthServ\\Parameters

HKEY_LOCAL_MACHINE\\SYSTEM\\CurrentControlSet\\Services\\BthServ\\Parameters\\Radio Support

"SupportDLL"=hex(2):25,00,73,00,79,00,73,00,74,00,65,00,6d,00,72,00,6f,00,6f,\

00,74,00,25,00,5c,00,73,00,79,00,73,00,74,00,65,00,6d,00,33,00,32,00,5c,00,\

72,00,73,00,75,00,70,00,70,00,6f,00,72,00,74,00,2e,00,64,00,6c,00,6c,00,00,\

00

MAKEFILE

复制代码
###### --------------------------------------------------------------------

######

###### Copyright(c) Microsoft Corp., 2012

######

###### --------------------------------------------------------------------

!ifdef NTMAKEENV

!INCLUDE $(NTMAKEENV)\makefile.def

!else # NTMAKEENV

!error - You forgot to set your build environment

!endif

RSupport.cpp

/*++ Copyright (c) Microsoft Corporation. All rights reserved.

THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY

KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE

IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR

PURPOSE.

Module Name:

Rsupport.cpp

Abstract:

--*/

DWORD WINAPI IsBluetoothRadioEnabled(BOOL* pfEnabled)

{

// If the radio is enabled, set *pfEnabled = TRUE else set *pfEnabled = FALSE

return ERROR_SUCCESS;

}

DWORD WINAPI BluetoothEnableRadio(BOOL fEnable)

{

if (fEnabled)

{

// Enable the radio here

}

else

{

// Disable the radio here

}

return ERROR_SUCCESS;

}

RSupport.def

/*++

Copyright (c) Microsoft Corporation. All rights reserved.

THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY

KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE

IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR

PURPOSE.

Module Name:

Rsupport.def

Abstract:

--*/

LIBRARY rsupport.dll

EXPORTS

BluetoothEnableRadio

IsBluetoothRadioEnabled

Sample SOURCES

#

# Copyright 2012 - Microsoft Corporation

#

TARGETNAME=rsupport

TARGETPATH=obj

TARGETTYPE=DYNLINK

UMTYPE=windows

USE_MSVCRT=1

TARGETLIBS= \

$(SDK_LIB_PATH)\kernel32.lib \

$(SDK_LIB_PATH)\user32.lib \

C_DEFINES=-DWIN32 -DUNICODE -D_UNICODE

SOURCES = RSupport.cpp
相关推荐
蚰蜒螟3 小时前
深入 Linux 内核同步机制:从 futex 到 spinlock 的完整旅程
linux·windows·microsoft
dllmayday4 小时前
Linux 上用终端连接 WiFi
linux·服务器·windows
charlie1145141918 小时前
Linux 字符设备驱动:cdev、设备号与设备模型
linux·开发语言·驱动开发·c
Curtain_Gin10 小时前
windows nvim lazy
windows
生而为虫12 小时前
Claude Code 最新版安装教程(Windows/Mac/Linux 全平台) 面向普通用户的 Claude Code 安装与模型接入指南
linux·windows·macos
DevilSeagull12 小时前
Windows 批处理 (Batch) 编程: 从入门到入土. (一) 基础概念与环境配置
开发语言·windows·后端·batch·语言
CyL_Cly13 小时前
Parsec(parsec安卓/windows/macos下载)
windows
XD74297163614 小时前
科技早报晚报|2026年5月2日:Spec 驱动开发、空口隔离交付与时序预测 Copilot,今天最值得跟进的 3 个机会
驱动开发·科技·copilot·开源项目·科技新闻·开发者工具
2601_9583205714 小时前
【小白零基础上手 】钉钉内部机器人接入 OpenClaw 完整流程讲解(含安装包)
人工智能·windows·机器人·钉钉·open claw·open claw安装
love530love15 小时前
f2 项目(多平台的作品下载与接口数据处理)源码部署记录
人工智能·windows·f2