种豆资源网

当前位置:首页 > 百科 > 百科综合 / 正文

ActivateDeviceEx

(2021-07-02 17:00:01) 百科综合

ActivateDeviceEx

设备管理器是如何载入驱动程式的呢?这里用到了一个重要的函式ActivateDeviceEx。
ActivateDeviceEx是指:
n 由设备管理器,也就是Device.exe来载入设备驱动;
n 注册表枚举时,用这个函式来读取启动时应当载入的驱动程式信息;
n ActivateDeviceEx将使用注册表中的Dll,Prefix,Index,Flags项。
ActivateDevice也能用来载入设备驱动,其实它内部也是调用了ActivateDevice
Ex。ActivateDeviceEx函式的主要功能就是用来载入驱动程式,它读取参数lpszDevKey中描述的注册表键来获取驱动程式的DLL名称、设备名前缀和其他相关信息(包括IOCTL等),这个函式可以用来替代ActivateDevice和RegisterDevice。
还以powerbutton为例,下面是注册表中它的相关内容。
[HKEY_LOCAL_MACHINE\Drivers\BuiltIn\PM]
"Prefix"="PWR"
"Dll"="pm.dll"
"Order"=dword:0
"Ioctl"=dword:4
"Index"=dword:0
"IClass"=multi_sz:"{A32942B7-920C-486b-B0E6-92A702A99B35}"
根据以上信息可以看出,在载入驱动程式时,调用ActivateDeviceEx函式的步骤为:
(1)ActivateDeviceEx(“\\HKEY_LOCAL_MACHINE\\Drivers\\BuiltIn\\PM”,…)
(2)ActivateDeviceEx函式将在\\HKEY_LOCAL_MACHINE\\Drivers\\BuiltIn\\PM键下寻找DLL的名称,在此也就是pm.dll,然后读取设备名前缀PWR以及index:0和其他信息。这里的index就是在前缀后面要添加上的序列号,如果是1,设备就是PWR1,它是用来妥善处理多重类似驱动设备在系统中被载入的情况。Index如果没有定义,设备管理器将为其指定一个空闲的索引号。
(3)ActivateDeviceEx将把设备添加到已激活设备列表中去。这时,如果没有定义index号,设备管理器必须指定一个空闲的索引号给设备,在添加完之后,设备管理器才将设备驱动载入到自己的进程上下文中。
下面是ActivateDeviceEx的函式原型:
HANDLE ActivateDeviceEx(
LPCWSTR lpszDevKey,
LPCVOID lpRegEnts,
DWORD cRegEnts,
LPVOID lpvParam
);
参数解释:
lpszDevKey
字元串指针,指向注册表中包含驱动信息的键,这个键应当包含驱动程式的DLL名、前缀、索引和入口点等信息。
lpRegEnts
指向REGINI结构体的数组,这个数组中定义了一些需要被添加到激活设备列表中的信息(ActivateDevice),这些信息填写后,驱动程式才被载入。如果是汇流排驱动的话,这里应该设定成NULL。
cRegEnts
lpRegEnts指向REGINI结构体的数组中元素的个数。
lpvParam
通过这个指针向已经载入的驱动程式传递参数,而不必将参数保留在注册表中,这个参数将以第2参数的角色被传递到XXX_Init(Device Manager)函式入口中。
返回值
如果返回具体设备的句柄,则代表操作成功,否则为失败。设备句柄可以在调DeactivateDevice函式的时候作为参数使用。

标 签

搜索
随机推荐

Powered By 种豆资源网||