| 名称 | HKMSetDevDescInfo 设置设备描述信息 | ||||||||
|---|---|---|---|---|---|---|---|---|---|
| 功能 | 设置无涯键鼠盒子的设备描述信息。这个函数设置无涯键鼠盒子的USB接口信息后,由于设备信息改变,系统会重新识别设备和自动安装驱动,需要等待几分钟或更长时间才能正常使用,这个过程中不要拔出盒子,否则会导致系统安装驱动失败。修改后需要关闭设备,等待系统安装驱动完成后再查找和打开设备,否则有些功能会受到影响,无法正常工作。无涯键鼠盒子基础版二代的固件版本大于等于1.2.0才支持此函数。 | ||||||||
| 参数 | 参数1 设备对象:无类型指针。使用HKMOpen可以创建它。 参数2 VID:无符号32位整形数。USB接口的制造商ID。可设置值的范围0-65535。值为65536时不修改无涯键鼠盒子VID值。 参数3 PID:无符号32位整形数。USB接口的产品ID。可设置值的范围0-65535。值为65536时不修改无涯键鼠盒子PID值。 参数4 版本:无符号32位整形数。USB接口的设备版本。可设置值的范围0-65535。值为65536时不修改无涯键鼠盒子版本值。 参数5 制造商名:字符串(Unicode/Ansi)或者无符号32/64位整型数(32位模块中是32位整型数,64位模块中是64位整型数)。USB接口的制造商名。设置制造商名是字符串(默认是Unicode字符串,可以通过HKMSetMode修改为Ansi字符串)。不修改制造商名时使用无符号32/64位整型数,值为1。 参数6 产品名:字符串(Unicode/Ansi)或者无符号32/64位整型数(32位模块中是32位整型数,64位模块中是64位整型数)。USB接口的产品名。设置产品名是字符串(默认是Unicode字符串,可以通过HKMSetMode修改为Ansi字符串)。不修改产品名时使用无符号32/64位整型数,值为1。 参数7 模式:无符号32位整形数。可取值如下:
|
||||||||
| 返回值 | 布尔值。成功返回TRUE,失败返回FALSE。 | ||||||||
| C语言 例子 |
DWORD dwDevId; LPVOID lpDev; dwDevId=HKMSearchDevice(0x1234,0xABCD,0); if(dwDevId==0xFFFFFFFF) { printf("未找到无涯键鼠盒子\n"); return 0; } lpDev=HKMOpen(dwDevId,0); if(lpDev==NULL) { printf("打开无涯键鼠盒子失败\n"); return 0; } //修改设备描述信息,PID和制造商名不修改 HKMSetDevDescInfo(lpDev,0x1235,0x10000,0x0101,(LPCWSTR)1,L"Mouse",1,FALSE); HKMClose(lpDev); |