Setupapi.h

本部分包含 Setupapi.h 标头的参考主题。

本节内容

主题	说明
SetupDiAskForOEMDisk	SetupDiAskForOEMDisk 函数显示一个对话框，询问用户 OEM 安装磁盘的路径。
SetupDiBuildClassInfoList	SetupDiBuildClassInfoList 函数返回一个安装程序类 GUID 列表，这些 GUID 标识在本地计算机上安装的类。
SetupDiBuildClassInfoListEx	SetupDiBuildClassInfoListEx 函数返回安装类 GUID 的列表，其中包括在本地系统或远程系统上安装的每个类。
SetupDiBuildDriverInfoList	SetupDiBuildDriverInfoList 函数生成与特定设备关联的驱动程序列表，或与设备信息集的全局类驱动程序列表相关联。
SetupDiCallClassInstaller	SetupDiCallClassInstaller 函数使用指定的安装请求（DIF 代码）调用相应的类安装程序和任何已注册的共同安装程序。
SetupDiCancelDriverInfoSearch	SetupDiCancelDriverInfoSearch 函数取消当前在不同的线程中正在进行的驱动程序列表搜索。
SetupDiChangeState	SetupDiChangeState 函数是 DIF_PROPERTYCHANGE 安装请求的默认处理程序。
SetupDiClassGuidsFromName	SetupDiClassGuidsFromName 函数检索与指定类名关联的 GUID。 此列表基于系统上当前安装的类生成。
SetupDiClassGuidsFromNameEx	SetupDiClassGuidsFromNameEx 函数检索与指定类名关联的 GUID。 生成的列表包含当前在本地或远程计算机上安装的类。
SetupDiClassNameFromGuid	SetupDiClassNameFromGuid 函数检索与类 GUID 关联的类名。
SetupDiClassNameFromGuidEx	SetupDiClassNameFromGuidEx 函数检索与类 GUID 关联的类名。 该类可以安装在本地或远程计算机上。
SetupDiCreateDeviceInfo	SetupDiCreateDeviceInfo 函数创建一个新的设备信息元素，并将其作为新成员添加到指定的设备信息集。
SetupDiCreateDeviceInfoList	SetupDiCreateDeviceInfoList 函数创建一个空的设备信息集，并选择性地将集与设备安装类和顶级窗口相关联。
SetupDiCreateDeviceInfoListEx	SetupDiCreateDeviceInfoList 函数在远程或本地计算机上创建一个空的设备信息集，并选择性地将该集与设备安装类相关联。
SetupDiCreateDeviceInterface	SetupDiCreateDeviceInterface 函数在本地系统或远程系统上注册设备接口。
SetupDiCreateDeviceInterfaceRegKey	SetupDiCreateDeviceInterfaceRegKey 函数创建一个注册表项，用于存储有关设备接口的信息，并返回密钥的句柄。
SetupDiCreateDevRegKey	SetupDiCreateDevRegKey 函数为特定于设备的配置信息创建注册表项，并返回密钥的句柄。
SetupDiDeleteDeviceInfo	SetupDiDeleteDeviceInfo 函数从设备信息集中删除设备信息元素。 此函数不会删除实际设备。
SetupDiDeleteDeviceInterfaceData	SetupDiDeleteDeviceInterfaceData 函数从设备信息集中删除设备接口。
SetupDiDeleteDeviceInterfaceRegKey	SetupDiDeleteDeviceInterfaceRegKey 函数删除应用程序和驱动程序用于存储特定于接口的信息的注册表子项。
SetupDiDeleteDevRegKey	SetupDiDeleteDevRegKey 函数删除与设备信息元素关联的指定用户可访问的注册表项。
SetupDiDestroyClassImageList	SetupDiDestroyClassImageList 函数销毁通过调用 SetupDiGetClassImageList 或 SetupDiGetClassImageListEx 生成的类映像列表。
SetupDiDestroyDeviceInfoList	SetupDiDestroyDeviceInfoList 函数删除设备信息集并释放所有关联的内存。
SetupDiDestroyDriverInfoList	SetupDiDestroyDriverInfoList 函数删除驱动程序列表。
SetupDiDrawMiniIcon	SetupDiDrawMiniIcon 函数在请求的位置绘制指定的迷你图标。
SetupDiEnumDeviceInfo	SetupDiEnumDeviceInfo 函数返回一个 SP_DEVINFO_DATA 结构，该结构指定设备信息集中的设备信息元素。
SetupDiEnumDeviceInterfaces	SetupDiEnumDeviceInterfaces 函数枚举设备信息集中包含的设备接口。
SetupDiEnumDriverInfo	SetupDiEnumDriverInfo 函数枚举驱动程序列表的成员。
SetupDiFinishInstallAction	SetupDiFinishInstallAction 函数是 DIF_FINISHINSTALL_ACTION 请求的默认处理程序。
SetupDiGetActualModelsSection	SetupDiGetActualModelsSection 函数检索从设备 INF 文件安装设备时要使用的相应修饰 INF 模型部分。
SetupDiGetActualSectionToInstall	SetupDiGetActualSectionToInstall 函数检索从本地计算机上的设备 INF 文件安装设备时要使用的相应 INF DDInstall 部分。
SetupDiGetActualSectionToInstallEx	SetupDiGetActualSectionToInstallEx 函数检索为指定操作系统和处理器体系结构安装设备的 INF DDInstall 部分。
SetupDiGetClassBitmapIndex	SetupDiGetClassBitmapIndex 函数检索为指定类提供的迷你图标的索引。
SetupDiGetClassDescription	SetupDiGetClassDescription 函数检索与指定安装程序类 GUID 关联的类说明。
SetupDiGetClassDescriptionEx	SetupDiGetClassDescriptionEx 函数检索本地或远程计算机上安装的安装程序类的说明。
SetupDiGetClassDevPropertySheets	SetupDiGetClassDevPropertySheets 函数检索设备信息元素的属性表或设备信息集的设备安装类的属性表的句柄。
SetupDiGetClassDevs	SetupDiGetClassDevs 函数返回包含本地计算机请求的设备信息元素的设备信息集的句柄。
SetupDiGetClassDevsEx	SetupDiGetClassDevsEx 函数返回包含本地或远程计算机请求的设备信息元素的设备信息集的句柄。
SetupDiGetClassImageIndex	SetupDiGetClassImageIndex 函数检索指定类的类图像列表中的索引。
SetupDiGetClassImageList	SetupDiGetClassImageList 函数生成一个图像列表，其中包含每个已安装类的位图，并返回数据结构中的列表。
SetupDiGetClassImageListEx	SetupDiGetClassImageListEx 函数为本地或远程系统上安装的每个类生成位图的图像列表。
SetupDiGetClassInstallParams	SetupDiGetClassInstallParams 函数检索设备信息集或特定设备信息元素的类安装参数。
SetupDiGetClassProperty	SetupDiGetClassProperty 函数检索为设备安装类或设备接口类设置的设备属性。
SetupDiGetClassPropertyEx	SetupDiGetClassPropertyEx 函数检索本地或远程计算机上的设备安装类或设备接口类的类属性。
SetupDiGetClassPropertyKeys	SetupDiGetClassPropertyKeys 函数检索设备属性项的数组，这些项表示为设备安装类或设备接口类设置的设备属性。
SetupDiGetClassPropertyKeysEx	SetupDiGetClassPropertyKeysEx 函数检索设备属性项的数组，这些项表示在本地或远程计算机上为设备安装类或设备接口类设置的设备属性。
SetupDiGetClassRegistryProperty	SetupDiGetClassRegistryProperty 函数从注册表中检索指定设备安装类的属性。
SetupDiGetCustomDeviceProperty	SetupDiGetCustomDeviceProperty 函数从注册表检索指定的自定义设备属性。
SetupDiGetDeviceInfoListClass	如果集具有关联的类，则 SetupDiGetDeviceInfoListClass 函数检索与设备信息集关联的设备安装类的 GUID。
SetupDiGetDeviceInfoListDetail	SetupDiGetDeviceInfoListDetail 函数检索与设备信息集关联的信息，包括类 GUID、远程计算机句柄和远程计算机名称。
SetupDiGetDeviceInstallParams	SetupDiGetDeviceInstallParams 函数检索设备信息集或特定设备信息元素的设备安装参数。
SetupDiGetDeviceInstanceId	SetupDiGetDeviceInstanceId 函数检索与设备信息元素关联的设备实例 ID。
SetupDiGetDeviceInterfaceAlias	SetupDiGetDeviceInterfaceAlias 函数返回指定设备接口的别名。
SetupDiGetDeviceInterfaceDetail	SetupDiGetDeviceInterfaceDetail 函数返回有关设备接口的详细信息。
SetupDiGetDeviceInterfaceProperty	SetupDiGetDeviceInterfaceProperty 函数检索为设备接口设置的设备属性。
SetupDiGetDeviceInterfacePropertyKeys	SetupDiGetDeviceInterfacePropertyKeys 函数检索设备属性项数组，这些项表示为设备接口设置的设备属性。
SetupDiGetDeviceProperty	SetupDiGetDeviceProperty 函数检索设备实例属性。
SetupDiGetDevicePropertyKeys	SetupDiGetDevicePropertyKeys 函数检索设备属性项数组，这些项表示为设备实例设置的设备属性。
SetupDiGetDeviceRegistryProperty	SetupDiGetDeviceRegistryProperty 函数检索指定的即插即用设备属性。
SetupDiGetDriverInfoDetail	SetupDiGetDriverInfoDetail 函数在设备信息集中检索设备信息集或特定设备信息元素的驱动程序信息详细信息。
SetupDiGetDriverInstallParams	SetupDiGetDriverInstallParams 函数检索设备信息集或特定设备信息元素的驱动程序安装参数。
SetupDiGetHwProfileFriendlyName	SetupDiGetHwProfileFriendlyName 函数检索与硬件配置文件 ID 关联的友好名称。
SetupDiGetHwProfileFriendlyNameEx	SetupDiGetHwProfileFriendlyNameEx 函数检索与本地或远程计算机上的硬件配置文件 ID 关联的友好名称。
SetupDiGetHwProfileList	SetupDiGetHwProfileList 函数检索当前定义的所有硬件配置文件 ID 的列表。
SetupDiGetHwProfileListEx	SetupDiGetHwProfileListEx 函数检索本地或远程计算机上当前定义的所有硬件配置文件 ID 的列表。
SetupDiGetINFClass	SetupDiGetINFClass 函数返回指定设备 INF 文件的类。
SetupDiGetSelectedDevice	SetupDiGetSelectedDevice 函数检索设备信息集中选定的设备信息元素。
SetupDiGetSelectedDriver	SetupDiGetSelectedDriver 函数检索设备信息集或特定设备信息元素的所选驱动程序。
SetupDiInstallClass	SetupDiInstallClass 函数安装指定 INF 文件的 ClassInstall32 部分。
SetupDiInstallClassEx	SetupDiInstallClassEx 函数安装类安装程序或接口类。
SetupDiInstallDevice	SetupDiInstallDevice 函数是 DIF_INSTALLDEVICE 安装请求的默认处理程序。
SetupDiInstallDeviceInterfaces	SetupDiInstallDeviceInterfaces 函数是 DIF_INSTALLINTERFACES 安装请求的默认处理程序。
SetupDiInstallDriverFiles	SetupDiInstallDriverFiles 函数是 DIF_INSTALLDEVICEFILES 安装请求的默认处理程序。
SetupDiLoadClassIcon	SetupDiLoadClassIcon 函数同时加载指定类的大图标和微型图标。
SetupDiLoadDeviceIcon	SetupDiLoadDeviceIcon 函数检索指定设备的图标。
SetupDiOpenClassRegKey	SetupDiOpenClassRegKey 函数打开安装程序类注册表项或特定类的子项。
SetupDiOpenClassRegKeyEx	SetupDiOpenClassRegKeyEx 函数将打开设备安装类注册表项、设备接口类注册表项或特定类的子项。 此函数在本地计算机或远程计算机上打开指定的项。
SetupDiOpenDeviceInfo	SetupDiOpenDeviceInfo 函数将设备实例的设备信息元素添加到设备信息集（如果设备信息集中尚不存在），并检索用于标识设备信息集中设备实例的设备信息元素的信息。
SetupDiOpenDeviceInterface	SetupDiOpenDeviceInterface 函数检索有关设备接口的信息，并将该接口添加到为本地系统或远程系统设置的指定设备信息集。
SetupDiOpenDeviceInterfaceRegKey	SetupDiOpenDeviceInterfaceRegKey 函数打开应用程序和驱动程序用来存储特定于设备接口的信息的注册表子项。
SetupDiOpenDevRegKey	SetupDiOpenDevRegKey 函数打开特定于设备的配置信息的注册表项。
SetupDiRegisterCoDeviceInstallers	SetupDiRegisterCoDeviceInstallers 函数是 DIF_REGISTER_COINSTALLERS 的默认处理程序。
SetupDiRegisterDeviceInfo	SetupDiRegisterDeviceInfo 函数是 DIF_REGISTERDEVICE 请求的默认处理程序。
SetupDiRemoveDevice	SetupDiRemoveDevice 函数是 DIF_REMOVE 安装请求的默认处理程序。
SetupDiRemoveDeviceInterface	SetupDiRemoveDeviceInterface 函数从系统中删除已注册的设备接口。
SetupDiRestartDevices	SetupDiRestartDevices 函数将重启指定的设备，或者如有必要，重新启动由同一函数运行的所有设备，并筛选运行指定设备的驱动程序。
SetupDiSelectBestCompatDrv	SetupDiSelectBestCompatDrv 函数是 DIF_SELECTBESTCOMPATDRV 安装请求的默认处理程序。
SetupDiSelectDevice	SetupDiSelectDevice 函数是 DIF_SELECTDEVICE 请求的默认处理程序。
SetupDiSelectOEMDrv	SetupDiSelectOEMDrv 函数为设备信息集或使用用户提供的 OEM 路径的特定设备信息元素选择驱动程序。
SetupDiSetClassInstallParams	SetupDiSetClassInstallParams 函数设置或清除设备信息集或特定设备信息元素的类安装参数。
SetupDiSetClassProperty	SetupDiSetClassProperty 函数为设备安装类或设备接口类设置类属性。
SetupDiSetClassPropertyEx	SetupDiSetClassPropertyEx 函数设置本地或远程计算机上的设备安装类或设备接口类的设备属性。
SetupDiSetClassRegistryProperty	SetupDiSetClassRegistryProperty 函数在注册表中设置指定的设备类属性。
SetupDiSetDeviceInstallParams	SetupDiSetDeviceInstallParams 函数设置设备信息集或特定设备信息元素的设备安装参数。
SetupDiSetDeviceInterfaceDefault	SetupDiSetDeviceInterfaceDefault 函数将设备接口设置为设备接口类的默认接口。
SetupDiSetDeviceInterfaceProperty	SetupDiSetDeviceInterfaceProperty 函数设置设备接口的设备属性。
SetupDiSetDeviceProperty	SetupDiSetDeviceProperty 函数设置设备实例属性。
SetupDiSetDeviceRegistryProperty	SetupDiSetDeviceRegistryProperty 函数设置设备的即插即用设备属性。
SetupDiSetDriverInstallParams	SetupDiSetDriverInstallParams 函数设置驱动程序信息元素的驱动程序安装参数。
SetupDiSetSelectedDevice	SetupDiSetSelectedDevice 函数将设备信息元素设置为设备信息集的选定成员。 此函数通常用于安装向导。
SetupDiSetSelectedDriver	SetupDiSetSelectedDriver 函数集或重置设备信息元素的所选驱动程序或设备信息集的所选类驱动程序。
SetupDiUnremoveDevice	SetupDiUnremoveDevice 函数是 DIF_UNREMOVE 安装请求的默认处理程序。
SetupGetInfDriverStoreLocation	SetupGetInfDriverStoreLocation 函数检索驱动程序存储区中 INF 文件的完全限定文件名（目录路径和文件名），该文件对应于系统 INF 文件目录中的指定 INF 文件或驱动程序存储区中的指定 INF 文件。
SetupGetInfPublishedName	SetupGetInfPublishedName 函数检索系统 INF 文件目录中 INF 文件的完全限定文件名（目录路径和文件名），该文件对应于驱动程序存储区中的指定 INF 文件或系统 INF 文件目录中的指定 INF 文件。
SetupGetNonInteractiveMode	SetupGetNonInteractiveMode 函数返回 SetupAPI 非交互式标志的值，该值指示调用方的进程是否可以通过用户界面组件（如对话框）与用户交互。
SetupGetThreadLogToken	SetupGetThreadLogToken 函数检索从中调用此函数的线程的日志令牌。
SetupSetNonInteractiveMode	SetupSetNonInteractiveMode 函数设置一个非交互式 SetupAPI 标志，该标志确定 SetupAPI 是否可以与调用方上下文中的用户交互。
SetupSetThreadLogToken	SetupSetThreadLogToken 函数为从中调用此函数的线程设置日志上下文（由日志令牌表示）。 对在同一线程内对 SetupGetThreadLogToken 的后续调用将检索最近为线程设置的日志令牌。
SetupWriteTextLog	SetupWriteTextLog 函数在 SetupAPI 文本日志中写入日志条目。
SetupWriteTextLogError	SetupWriteTextLogError 函数将有关 SetupAPI 特定错误或 Win32 系统错误的信息写入 SetupAPI 文本日志。
SetupWriteTextLogInfLine	SetupWriteTextLogInfLine 函数在 SetupAPI 文本日志中写入一个日志条目，其中包含指定 INF 文件行的文本。
SP_ADDPROPERTYPAGE_DATA	在处理 DIF_ADDPROPERTYPAGE_ADVANCED 请求时，安装程序使用 SP_ADDPROPERTYPAGE_DATA 结构为设备提供自定义属性页。
SP_ALTPLATFORM_INFO	SP_ALTPLATFORM_INFO 结构指定给定计算机、操作系统版本和计算机的处理器体系结构。
SP_CLASSIMAGELIST_DATA	SP_CLASSIMAGELIST_DATA 结构描述类图像列表。
SP_CLASSINSTALL_HEADER	SP_CLASSINSTALL_HEADER 是任何类安装参数结构的第一个成员。 它包含用于定义安装参数结构的其余部分格式的设备安装请求代码。
SP_DETECTDEVICE_PARAMS	SP_DETECTDEVICE_PARAMS 结构对应于 DIF_DETECT 安装请求。
SP_DEVICE_INTERFACE_DATA	SP_DEVICE_INTERFACE_DATA 结构定义设备信息集中的设备接口。
SP_DEVICE_INTERFACE_DETAIL_DATA	SP_DEVICE_INTERFACE_DETAIL_DATA 结构包含设备接口的路径。
SP_DEVINFO_DATA	SP_DEVINFO_DATA 结构定义设备实例，该实例是设备信息集的成员。
SP_DEVINFO_LIST_DETAIL_DATA	SP_DEVINFO_LIST_DETAIL_DATA 结构包含有关设备信息集的信息，例如其关联的设置类 GUID（如果其具有关联的安装类）。
SP_DEVINSTALL_PARAMS	SP_DEVINSTALL_PARAMS 结构包含与特定设备信息元素关联的设备安装参数或与设备信息集全局关联的设备安装参数。
SP_DRVINFO_DATA	SP_DRVINFO_DATA 结构包含有关驱动程序的信息。 此结构是驱动程序信息列表的成员，可以与特定设备实例相关联，也可以全局与设备信息集相关联。
SP_DRVINFO_DETAIL_DATA	SP_DRVINFO_DETAIL_DATA 结构包含有关特定驱动程序信息结构的详细信息。
SP_DRVINSTALL_PARAMS	SP_DRVINSTALL_PARAMS 结构包含与特定驱动程序信息元素关联的驱动程序安装参数。
SP_NEWDEVICEWIZARD_DATA	安装程序使用 SP_NEWDEVICEWIZARD_DATA 结构通过添加自定义页面来扩展硬件安装向导的操作。 它用于 DIF_NEWDEVICEWIZARD_XXX 安装请求。
SP_POWERMESSAGEWAKE_PARAMS	SP_POWERMESSAGEWAKE_PARAMS 结构对应于 DIF_POWERMESSAGEWAKE 安装请求。
SP_PROPCHANGE_PARAMS	SP_PROPCHANGE_PARAMS 结构对应于 DIF_PROPERTYCHANGE 安装请求。
SP_PROPSHEETPAGE_REQUEST	SP_PROPSHEETPAGE_REQUEST 结构可以作为第一个参数 (lpv) 传递给 SetupAPI DLL 中的 ExtensionPropSheetPageProc 入口点。 ExtensionPropSheetPageProc 用于检索指定属性表页的句柄。 有关 ExtensionPropSheetPageProc 和相关函数的信息，请参阅 Microsoft Windows SDK 文档。
SP_REMOVEDEVICE_PARAMS	SP_REMOVEDEVICE_PARAMS 结构对应于 DIF_REMOVE 安装请求。
SP_SELECTDEVICE_PARAMS	SP_SELECTDEVICE_PARAMS 结构对应于 DIF_SELECTDEVICE 安装请求。
SP_TROUBLESHOOTER_PARAMS	SP_TROUBLESHOOTER_PARAMS 结构对应于 DIF_TROUBLESHOOTER 安装请求。
SP_UNREMOVEDEVICE_PARAMS	SP_UNREMOVEDEVICE_PARAMS 结构对应于 DIF_UNREMOVE 安装请求。

向 Microsoft 发送有关本主题的评论