有关驱动程序函数Word格式.docx
- 文档编号:3230570
- 上传时间:2023-05-01
- 格式:DOCX
- 页数:41
- 大小:28.74KB
有关驱动程序函数Word格式.docx
《有关驱动程序函数Word格式.docx》由会员分享,可在线阅读,更多相关《有关驱动程序函数Word格式.docx(41页珍藏版)》请在冰点文库上搜索。
如果这个参数被指定(赋值),SetupDiAskForOEMDisk要关联与正在安装的设备的驱动程序。
如果该参数为NULL,SetupDiAskForOEMDisk要关联与全局性的DeviceInfoSet驱动程序列表中的驱动程序。
返回值:
如果它是正确则返回TRUE并且SP_DEVINSTALLPARAMS结构DriverPath字段更新,以反映新的路径。
如果用户取消对话框,该函数返回FALSE,并以GetLastError返回调用ERROR_CANCELLED
2、函数:
SetupDiBuildClassInfoList
返回一个设置类的GUID列表,这个列表是确定是在本地计算机上安装类
SetupDiBuildClassInfoList(
IN
DWORD
Flags,
OUT
LPGUID
ClassGuidList,
ClassGuidListSize,
PDWORD
RequiredSize
)
参数:
Flags:
用于控制那些类是排除在列表中的类。
如果没有指定Flags,所有的设置类都要列入列表中。
可以是下列值的组合:
DIBCI_NOINSTALLCLASS排除一类是否在其注册表项值项NoInstallClass;
DIBCI_NODISPLAYCLASS排除一类是否在其注册表项值项NoDisplayClass
ClassGuidList:
一个GUID指针类型的数组,收到的安装类GUID列表。
该指针是可选的,可以为NULL
ClassGuidListSize:
由ClassGuildList参数指向数组中GUIDs的数量(容量)。
如果ClassGuidList为NULL,ClassGuidSize必须为零
RequiredSize:
一个DWORD指针类型的变量,它接收GUID返回的数字(如果数字小于或等于在GUID中指向的ClassGuidList参数数组的大小,如果这个数字比ClassGuidList数组的大小大,它表示有多大ClassGuidList数组必须以包含在GUID中)。
如果正确返回TRUE,否则返回FALSE,并且可以记录检索GetLastError函数调用的错误。
3、函数:
SetupDiBuildClassInfoListEx
返回一个设置GUID类的列表,其中包括在本地系统或远程系统上安装的每一个类
SetupDiBuildClassInfoListEx(
RequiredSize,
PCTSTR
MachineName..OPTIONAL,
PVOID
Reserved,
DIBCI_NOINSTALLCLASS排除一类有否在其注册表项NoInstallClass值项。
DIBCI_NODISPLAYCLASS排除一类有否在其注册表项NoDisplayClass值项。
一个接收的安装GUID类的列表的缓冲区的指针
提供在ClassGuildList数组里GUIDs的数量
MachineName:
以NULL指针结束的字符串,其中包含从远程计算机上安装的检索设置类的名称。
如果MachineName是NULL,则这个函数建立一个本地计算机上安装的类的列表
Reserved:
必须为NULL
4、函数:
SetupDiBuildDriverInfoList
建立一个与一个特定的设备,或与全球级的设备驱动程序列表中的信息相关的驱动程序的列表。
SetupDiBuildDriverInfoList(
DeviceInfoData..OPTIONAL,
DriverType
DeviceInfoSet:
一个设备信息设置的句柄,这些句柄包含在驱动程序列表中,无论是所有设备的信息元素或单个设备的信息内容具体。
该设备信息集不能包含远程设备的信息内容
DeviceInfoDat:
一个SP_DEVINFO_DATA结构的指针,对于这个SP_DEVINFO_DATA结构里都是在DeviceInfoSet的设备信息元素,其中这些元素表示了该设备建立的驱动程序列表。
如果该参数指定,要与指定的设备联系。
如果该参数为NULL,DeviceInfoSet驱动程序与列表相关联。
如果这个设备类别因为建立一个兼容的驱动程序的清单而更新,则DeviceInfoData.ClassGuid更新后再返回。
DriverType:
驱动程序列表的建立类型。
必须是下列值之一:
SPDIT_CLASSDRIVER建立一个类驱动程序的列表。
如果DeviceInfoData为NULL,该驱动程序列表类型必须指定。
SPDIT_COMPATDRIVER建立一个兼容的驱动程序的列表。
DeviceInfoData不能是NULL如果此驱动程序列表中指定类型
5、函数:
SetupDiCallClassInstaller
功能:
调用适当的类安装程序,任何注册公司要使用指定的安装要求。
SetupDiCallClassInstaller(
DI_FUNCTION
InstallFunction,
InstallFunction:
该设备的安装请求传递给安装人员和安装程序,DIF的格式有DIF_XXX并且要以Setupapi.h定义,可以看一下DeviceInstallationFunctionCodes相关信息。
注意:
对于DIF请求,调用者必须是Administrators组的成员,对于DIF的请求已经列入相关的页面默认处理程序。
本地计算机上设置信息的句柄,这组信息包含一个设备的安装元素,这些元素代表了设备执行指定安装的功能。
DeviceInfoData:
一个SP_DEVINFO_DATA结构指定的DeviceInfoSet的表示该装置执行指定安装的功能设备的信息元素的指针。
如果此参数指定,则SetupDiCallClassInstaller上执行DeviceInfoData元素指定的函数。
如果DeviceInfoData为NULL,则SetupDiCallClassInstaller调用设置与DeviceInfoSet相关的安装的类。
6、函数:
SetupDiCancelDriverInfoSearch
取消的SetupDiCancelDriverInfoSearch功能的目前正在进行在不同的线程的驱动程序的列表搜索
SetupDiCancelDriverInfoSearch(
一个有关驱动程序列表正在建立的设备信息集的句柄。
当这个函数被调用时,如果一个驱动程序列表正在对指定的设备信息集进行搜素,则搜素终止。
当搜素终止时SetupDiCancelDriverInfoSearch返回TRUE,否则返回FALSE,并调用GetLastError则返回ERROR_INVALID_HANDLE。
7、函数:
SetupDiChangeState
为DIF_PROPERTYCHANGE安装请求进行默认的处理。
SetupDiChangeState(
为本地计算机上的信息设置的句柄,这些信息集包含了设备信息上的元素,这些元素表示设备状态的改变。
一个SP_DEVINFO_DATA结构,规定有关DeviceInfoSet设备信息元素的指针。
这是IN-OUT参数,因为DeviceInfoData.DevInst可能是更新处理后的返回值。
8、函数:
SetupDiClassGuidsFromName
检索的GUID与指定类名称关联。
此列表是建基于当前安装在系统上的类
SetupDiClassGuidsFromName(
ClassName,
ClassName:
检索GUID类的类的名称
一个数组的指针,以获得与指定类名称关联的GUID列表
ClassGuidList数组GUID的数量
提供一个指针变量,接收与类名相关的GUID数量,如果这个数字比ClassGuidList缓冲区的大小,数字显示多大数组必须以存储在所有的GUID。
9、函数:
SetupDiClassGuidsFromNameEx
检索与GUID类关联的指定类名称,这个列表包含目前在本地或远程计算机上安装的类
SetupDiClassGuidsFromNameEx(
Reserved
以NULL指针结束的字符串,其中包含一个远程系统,该系统检索的GUID名称。
如果MachineName是NULL,则本地系统的名称使用
必须为空
10、函数:
SetupDiClassNameFromGuid
检索与GUID类相关的类的名称
SetupDiClassNameFromGuid(
ClassGuid,
PTSTR
ClassNameSize,
RequiredSize
ClassGuid:
对类的指针的GUID的类名来检索
一个缓冲区,它接收NULL结尾的字符串,它包含的是通过在ClassGuid参数的指针指向指定的类的名称
ClassNameSize:
在字符里,缓冲区的大小是有ClassName所指出。
在字符里,一个以Null结尾的类名的最大的是MAX_CLASS_NAME_LEN
一个指针变量,用来接收以NULL结尾的类名字符数所需的存储请求,该指针是可选的,可以为NULL。
11、函数:
SetupDiClassNameFromGuidEx
检索类名与类相关的GUID。
类可以安装在本地或远程计算机
SetupDiClassNameFromGuidEx(
RequiredSize..OPTIONAL,
用来检索GUID类的名称
一个字符串缓冲区的指针,他用来接收以NULL结尾所指定的GUID类的名称
在字符中,ClassName缓冲区的大小
以NULL指针结束的字符串,其中包含一个远程系统上安装的类的名称。
如果MachineName是NULL,则本地系统的名称使用。
12、函数:
SetupDiCreateDeviceInfo
创建一个新的设备的信息内容,并增加了一个新成员到指定的设备资料集。
SetupDiCreateDeviceInfo(
DeviceName,
DeviceDescription..OPTIONAL,
HWND
hwndParent..OPTIONAL,
CreationFlags,
一个本地计算机中的设备信息集的句柄
DeviceName:
一个以NULL结尾的字符串的指针,用来提供一个全设备例如实例标识符,“根\*PNP0500\0000”)或根枚举识别没有枚举实例标识符的前缀和后缀(例如设备标识符,“*PNP0500“)。
根枚举设备标识符只有在CreationFlags参数中指定DICD_GENERATE_ID标志时才能使用。
一个设备安装类的GUID类的指针,如果该设备的设备安装类别不知道,设置*ClassGuid为GUID_NULL结构。
DeviceDescription:
一个NULL指针结尾的字符串,用来提供设备的文字描述。
hwndParent:
一个用于任何用安装相关设备的户界面的顶层窗口的指针,这种句柄是可选的,可以为NULL
CreationFlags:
一种双字节的变量,用来控制设备信息是如何创建的元素。
DICD_GENERATE_ID如果这个标志被指定,DeviceName的只包含一个根枚举设备的ID和系统创建了一个独特的设备,例如它的键值。
这种独特的设备实例生成的关键是:
枚举\根\设备名称\InstanceID。
凡InstanceID是一个4位,以10基准的数量是根据枚举所有子独特的\根\设备名称。
调用SetupDiGetDeviceInstanceId找出对于该设备的信息元素而形成的ID。
DICD_INHERIT_CLASSDRVS如果这个标志被指定,由此产生的设备信息元素继承的类驱动程序列表,如果有的话,该设备的信息相关联。
此外,如果有一个设备的信息集,同样的驱动程序中选择了新的设备的信息内容。
SP_DEVINFO_DATA结构的指针,用来接收新设备的信息元素,该指针是可选的,可以为NULL。
如果支持这种结构,调用者必须在调用这个函数前设置这个结构cbSize成员为sizeof(SP_DEVINFO_DATA)。
13、函数:
SetupDiCreateDeviceInfoList
创建一个空的设备信息集,并且选择相关联的设备安装类和顶层窗口设置
HDEVINFO
SetupDiCreateDeviceInfoList(
ClassGuid..OPTIONAL,
hwndParent
与新创建的设备信息的指针设备的安装程序类GUID关联集。
如果该参数指定,这个类的专用设备,可以在该设备包含的资料集。
如果此参数设置为NULL,设备信息集不与特定的设备安装类别。
用于任何界面的相关非设备的顶层窗口的句柄(如选择设备对话框中使用全局类驱动程序列表),这种处理是可选的,可以为NULL。
如果一个特定的顶级窗口不是必需的,设置hwndParent为NULL。
如果它是正确的,该函数返回的句柄空设备信息集。
否则,它返回INVALID_HANDLE_VALUE
14、函数:
SetupDiCreateDeviceInfoListEx
用来创建一个在远程或本地计算机上设置空的设备信息集并且可以选择与这个设置相关的设备安装类。
SetupDiCreateDeviceInfoListEx(
以NULL指针结束的字符串,其中包含网络上的计算机的名称。
如果一个指定名称,该计算机上可以创建和打开这个设备信息设置的专用设备。
如果此参数设置为NULL,该设备信息集是在本地计算机上的设备。
15、函数:
SetupDiCreateDeviceInterface
注册一个本地或远程系统的设备接口
SetupDiCreateDeviceInterface(
DeviceInfoData,
InterfaceClassGuid,
ReferenceString..OPTIONAL,
PSP_DEVICE_INTERFACE_DATA
DeviceInterfaceData
设备信息集的句柄,这个信息集包含一个设备信息元素,代表了装置的注册接口。
这种处理通常是由SetupDiGetClassDevs返回。
一个SP_DEVINFO_DATA结构,规定有关DeviceInfoSet设备信息元素的指针
InterfaceClassGuid:
一个指定新的接口的接口的类GUID的指针
ReferenceString:
以NULL结束的提供了参考的字符串的指针,该指针是可选的,可以为NULL。
参考
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 有关 驱动程序 函数