windows下设备的Setup ClassGuid/Device Interface ClassGUID

最新推荐文章于 2024-04-14 03:11:36 发布
最新推荐文章于 2024-04-14 03:11:36 发布
阅读量8.5k 收藏 15
点赞数 3
分类专栏： win内核 文章标签： windows
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/lixiangminghate/article/details/52345711
版权

    windows下与设备相关的各种guid名目繁多,MSDN上的解释也写的扑朔迷离,因此想借本文总结一下这些guid应用场景.

    1.最常见的应该是Setup ClassGuid--设备安装类了.当我们打开设备管理器,默认情况下看到的设备列表就是按设备类型----更确切的讲是设备安装类型来排列显示的.比如,windwos将所有的网卡(PCI网卡/无线网卡/外接USB网卡)归到网络适配器一类;将独显集显归到显示适配器一类...windows这样归类的依据是,为同一类设备在驱动安装期间提供相同的安装行为.这种分类方式称为设备安装类(Setup Class).为了唯一的标示各种安装类,MS又用GUID加以区分,因此形成了Setup Class Guid.目前,MS为常见的设备安装类约定了各自的GUID,比如网卡的Setup Class GUID是{4d36e972-e325-11ce-bfc1-08002be10318}.而一些非主流的设备,需要vender自己定义设备安装类,如DDK样例toaster就自立门户的定义了一个设备安装类.除了在设备管理器中可以找到设备安装类GUID,我们可以在注册表项HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Class找到各种设备类GUID.附带一句,inf文件的[VERSION]节ClassGUID键的值同样也是Setup Class Guid

[version]
Signature   = "$Windows NT$"
Class       = Net ;Realtek PCIe GBE Family Controller网卡的inf文件
ClassGUID   = {4d36e972-e325-11ce-bfc1-08002be10318}
    在代码中访问设备安装类的流程可以参照我前面的blog: 整理SetupDixxx函数

    

    2.接着说说Device Interface Class.如果说Setup Class是按设备安装方式而进行分类,那Device Interface Class的功能相对较多:1).可以监听同一类设备是否被注册或者同属一个Device Interface Class中设备的interface被使能;2).用于枚举并打开设备.

    先看第一个功能,注册监听器.在驱动程序中,Fdo程序往往会在AddDevice中注册接口,并在其后IRP_MN_STARTDEVICE中调用IoSetDeviceInterfaceState来使能一个接口供其他系统中其他程序调用;系统中的其他驱动可以通过调用IoRegisterPlugPlayNotification来注册一个回调函数来获取接口使能的事件.MSDN如是注释:

The IoRegisterPlugPlayNotification routine registers a driver callback routine to be called when a PnP event of the specified category occurs. 
NTSTATUS 
  IoRegisterPlugPlayNotification(
    IN IO_NOTIFICATION_EVENT_CATEGORY  EventCategory,
    IN ULONG  EventCategoryFlags,
    IN PVOID  EventCategoryData  OPTIONAL,
    IN PDRIVER_OBJECT  DriverObject,
    IN PDRIVER_NOTIFICATION_CALLBACK_ROUTINE  CallbackRoutine,
    IN PVOID  Context,
    OUT PVOID  *NotificationEntry
    );
EventCategory 
Specifies the category of PnP event for which the callback routine is being registered. EventCategory must be one of the following: 
EventCategoryDeviceInterfaceChange 
PnP events in this category include the arrival (enabling) of a new instance of a device interface class (GUID_DEVICE_INTERFACE_ARRIVAL), 
or the removal (disabling) of an existing device interface instance (GUID_DEVICE_INTERFACE_REMOVAL).

    ReactOS启动过程1调用PoInitSystem初始化电源管理器时,调用IoRegisterPlugPlayNotification监听ACPI Fixed Button接口使能事件:

BOOLEAN
NTAPI
PoInitSystem(IN ULONG BootPhase,
             IN BOOLEAN HaveAcpiTable)
{
    IoRegisterPlugPlayNotification(EventCategoryDeviceInterfaceChange,
                                       0, /* The registry has not been initialized yet */
                                       (PVOID)&GUID_DEVICE_SYS_BUTTON,
                                       IopRootDeviceNode->
                                       PhysicalDeviceObject->DriverObject,
                                       PopAddRemoveSysCapsCallback,
                                       NULL,
                                       &NotificationEntry);
}
参数5即为回调函数,他要做的就是当接收到事件后,打开使能的接口以便后续处理: 

NTSTATUS
NTAPI
PopAddRemoveSysCapsCallback(
	IN PVOID NotificationStructure,
	IN PVOID Context)
{
	Notification = (PDEVICE_INTERFACE_CHANGE_NOTIFICATION)NotificationStructure;

	if (Notification->Size != sizeof(DEVICE_INTERFACE_CHANGE_NOTIFICATION))
		return STATUS_INVALID_PARAMETER;
	if (RtlCompareMemory(&Notification->Event, &GUID_DEVICE_INTERFACE_ARRIVAL, sizeof(GUID) == sizeof(GUID)))
		Arrival = TRUE;
	else if (RtlCompareMemory(&Notification->Event, &GUID_DEVICE_INTERFACE_REMOVAL, sizeof(GUID) == sizeof(GUID)))
		Arrival = FALSE;
	else
		return STATUS_INVALID_PARAMETER;


		InitializeObjectAttributes(
			&ObjectAttributes,
			Notification->SymbolicLinkName, //获得符号链接名
			OBJ_KERNEL_HANDLE,
			NULL,
			NULL);
		//打开设备
		Status = ZwOpenFile(
			&FileHandle,
			FILE_READ_DATA,
			&ObjectAttributes,
			&IoStatusBlock,
			FILE_SHARE_READ | FILE_SHARE_WRITE,
			0);

		Status = ObReferenceObjectByHandle(
			FileHandle,
			FILE_READ_DATA,
			IoFileObjectType,
			ExGetPreviousMode(),
			(PVOID*)&FileObject,
			NULL);

		DeviceObject = IoGetRelatedDeviceObject(FileObject);
		ObDereferenceObject(FileObject);

		KeInitializeEvent(&Event, NotificationEvent, FALSE);
		Irp = IoBuildDeviceIoControlRequest(
			IOCTL_GET_SYS_BUTTON_CAPS,
			DeviceObject,
			NULL,
			0,
			&Caps,
			sizeof(Caps),
			FALSE,
			&Event,
		//应该是向底层ACPI.sys发送IRP,然后由BIOS完成相应的处理
		Status = IoCallDriver(DeviceObject, Irp);

    同样应用程序可以通过调用RegisterDeviceNotification得到类似的效果,如winddk/src/usb/usbview程序中,usbview.c调用RegisterDeviceNotification获得usb插入事件.

    broadcastInterface.dbcc_size = sizeof(DEV_BROADCAST_DEVICEINTERFACE);
    broadcastInterface.dbcc_devicetype = DBT_DEVTYP_DEVICEINTERFACE;

    memcpy( &(broadcastInterface.dbcc_classguid),
            &(GUID_CLASS_USB_DEVICE),
            sizeof(struct _GUID));

    gNotifyDevHandle = RegisterDeviceNotification(hWnd,
                                                  &broadcastInterface,
                                                  DEVICE_NOTIFY_WINDOW_HANDLE);

    // Now register for Hub notifications.
    memcpy( &(broadcastInterface.dbcc_classguid),
            &(GUID_CLASS_USBHUB),
            sizeof(struct _GUID));

    gNotifyHubHandle = RegisterDeviceNotification(hWnd,
                                                  &broadcastInterface,
                                                  DEVICE_NOTIFY_WINDOW_HANDLE);
    不过RegisterDeviceNotification注册的事件发生后,貌似是用win32消息发送给制定窗口,由窗口进行事件处理.

    说完Device Interface Class的监听功能,再来说说它枚举和打开设备接口的功能.前面也说过,Fdo会在创建设备后为设备创建一个Interface,供上层应用程序访问,引入设备接口的原因是避免设备名冲突,不能保证自己为设备取的SymbolicLink不会和系统中其他设备的SymbolicLink重名,而引入设备接口后,通过128bit的数字指定设备名,就减少了重名的可能.

    

   以toaster驱动为例,他创建了一个接口.从winobj输出来看,其接口名是InstanceID+InterfaceGuid形式,这样大大减小了重名的概率.当然这也增加了程序访问设备的难度,这里我简单列出toaster中enum.exe枚举Device Interface ClassGUID然后打开Interface的代码以供参考:

//这段是驱动中注册接口
DEFINE_GUID (GUID_DEVINTERFACE_BUSENUM_TOASTER,
        0xD35F7840, 0x6A0C, 0x11d2, 0xB8, 0x41, 0x00, 0xC0, 0x4F, 0xAD, 0x51, 0x71);
//  {D35F7840-6A0C-11d2-B841-00C04FAD5171}

NTSTATUS
Bus_AddDevice(
    PDRIVER_OBJECT DriverObject,
    PDEVICE_OBJECT PhysicalDeviceObject
    )
{
    ...

    status = IoCreateDevice (
                    DriverObject,               // our driver object
                    sizeof (FDO_DEVICE_DATA),   // device object extension size
                    NULL,                       // FDOs do not have names
                    FILE_DEVICE_BUS_EXTENDER,   // We are a bus
                    FILE_DEVICE_SECURE_OPEN,    //
                    TRUE,                       // our FDO is exclusive
                    &deviceObject);   
    ...
    status = IoRegisterDeviceInterface (
                PhysicalDeviceObject,
                (LPGUID) &GUID_DEVINTERFACE_BUSENUM_TOASTER,
                NULL,
                &deviceData->InterfaceName);
} 

NTSTATUS
Bus_StartFdo (
    PFDO_DEVICE_DATA            FdoData,
    PIRP   Irp )
{
    ...
    status = IoSetDeviceInterfaceState(&FdoData->InterfaceName, TRUE);
    ...
}

//这段摘自应用层enum.cpp 枚举Interface guid并打开设备
hardwareDeviceInfo = SetupDiGetClassDevs (
                       (LPGUID)&GUID_DEVINTERFACE_BUSENUM_TOASTER,
                       NULL, // Define no enumerator (global)
                       NULL, // Define no
                       (DIGCF_PRESENT | // Only Devices present
                       DIGCF_DEVICEINTERFACE)); // Function class devices.

    deviceInterfaceData.cbSize = sizeof (SP_DEVICE_INTERFACE_DATA);

    if (SetupDiEnumDeviceInterfaces (hardwareDeviceInfo,
                                 0, // No care about specific PDOs
                                 (LPGUID)&GUID_DEVINTERFACE_BUSENUM_TOASTER,
                                 0, //
                                 &deviceInterfaceData)) {

    SetupDiGetDeviceInterfaceDetail (
            HardwareDeviceInfo,
            DeviceInterfaceData,
            NULL, // probing so no output buffer yet
            0, // probing so output buffer length of zero
            &requiredLength,
            NULL); // not interested in the specific dev-node

    predictedLength = requiredLength;

    deviceInterfaceDetailData = malloc (predictedLength);

    if(deviceInterfaceDetailData)
        deviceInterfaceDetailData->cbSize =
                      sizeof (SP_DEVICE_INTERFACE_DETAIL_DATA);


    if (! SetupDiGetDeviceInterfaceDetail (
               HardwareDeviceInfo,
               DeviceInterfaceData,
               deviceInterfaceDetailData,
               predictedLength,
               &requiredLength,
               NULL)) {
        printf("Error in SetupDiGetDeviceInterfaceDetail\n");
        free (deviceInterfaceDetailData);
        return FALSE;
    }

    file = CreateFile ( deviceInterfaceDetailData->DevicePath,
                        GENERIC_READ, // Only read access
                        0, // FILE_SHARE_READ | FILE_SHARE_WRITE
                        NULL, // no SECURITY_ATTRIBUTES structure
                        OPEN_EXISTING, // No special create flags
                        0, // No special attributes
                        NULL); // No template file




Eugene800
关注
  • 3
    点赞
  • 踩
  • 15
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
Device Interface Class GUID和Device Setup Class GUID
Dorthyn的博客
05-31 1911
Device Interface Class GUID和Device Setup Class GUID 20180516 两者是不一样的。 There seems to be confusion in this thread about two completely different classes so let me try to clear this up. A Device...
常见设备的GUID
eric422113的专栏
07-14 1万+
用SetupDi*类函数可以进行设备管理，其中就要用到设备类的GUID。    全球唯一标识符 (GUID) 是一个字母数字标识符，用于指示产品的唯一性安装。在许多流行软件应用程序（例如 Web 浏览器和媒体播放器）中，都使用 GUID。    GUID 的格式为“xxxxxxx
Device Interface class GUID和Device Setup Class GUID
u010771496的博客
08-14 1349
Device Interface class GUID和Device Setup Class GUID 1.Device Interface class GUID 设备接口类GUID（Device Interface class GUID),是由驱动程序负责添加的该GUID出现在注册表中KKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Devi...
驱动ClassGUID
simcor的博客
11-19 975
文件位置：C:\Program Files (x86)\Windows Kits\10\Include\10.0.22000.0\shared\devguid.h 10.0.22000.0 是 SDK 版本 /*++ BUILD Version: 0001 // Increment this if a change has global effects Copyright (c) Microsoft Corporation. All rights reserved. Module Name:
获取device的InterfaceClassGUID
u010784648的专栏
09-29 3194
SetupDiEnumDeviceInterfaces函数里有个参数需要用到InterfaceClassGUID，找了很长时间这个值，众说纷纭啊！最后发现原来是微软已经定义的这些指，不过这些值有部分是定义在WinDDK里的，需要查找msdn(http://msdn.microsoft.com/en-us/library/windows/hardware/ff541392(v=vs.85).aspx
Device Class GUIDs for Popular Types of Hardware
sandro_zhang的专栏
09-19 1216
今天发现驱动的类的GUID都是唯一的，不能随意更改，找到了一个列表，记录下来。 Other than programming for a device driver, the Globally Unique Identifier (GUID) for a device
【Docker】Windows11操作系统下安装、使用Docker保姆级教程_docker windo11
最新发布
wdsfgj的博客
04-14 1万+
最近很多小伙伴找我要Linux学习资料，于是我翻箱倒柜，整理了一些优质资源，涵盖视频、电子书、PPT等共享给大家！最近很多小伙伴找我要Linux学习资料，于是我翻箱倒柜，整理了一些优质资源，涵盖视频、电子书、PPT等共享给大家！
驱动声明GUID
Jangel Lee的专栏
09-03 1152
winCE提供驱动声明为 可支持电源管理的GUID 有4个，分别代表4中外设类型。是固定的。 具体可以看看common.reg ; Power Manager interfaces.  These list the interface classes that the Power ; Manager will monitor for new devices. ; [HKEY_LOCAL_
C++开发的Windows中读取Bios信息.7z
07-12
2. **设备接口类（Device Interface Class, DIC）**： - Windows使用DIC来识别和访问特定类型的设备。对于BIOS，我们可以使用`GUID_DEVCLASS_SYSTEM`来获取系统设备的信息。 3. **设备信息集（Device Information ...
C# 访问USB(HID)设备
03-30
hDevInfo = SetupDiGetClassDevs(ref guidHID, 0, IntPtr.Zero, DIGCF.DIGCF_DEVICEINTERFACE | DIGCF.DIGCF_PRESENT); ``` #### 四、获取设备接口信息 一旦我们有了设备信息集合（`hDevInfo`），就可以通过`...
GUID就能获得设备路径
11-04
有了设备名(路径)，就可以直接调用CreateFile打开设备，进行它所支持的I/O操作了。如果事先并不能确切知道设备名，如何去访问设备呢？
通过串口号获得该串口号对应的设备信息.docx
12-23
又是一顿搜索，最后找到两篇介绍用C#调用API的文章，然后通过一个例子向大家讲解如何使用API：HDEVINFO SetupDiGetClassDevs(const GUID* ClassGuid, PCTSTR Enumerator, HWND hwndParent, DWORD Flags);这个函数...
Win32_MFC.rar_HID 拔插检测_MFC HID_USB HID拔插检测_USB设备插拔检测 U盘 鼠标_usb
09-23
在VS2008环境下，使用MFC进行编程，我们需要包含必要的头文件，如Windows.h和setupapi.h，这两个文件提供了处理设备接口的API。接下来，我们需要实现一个设备接口类，该类负责注册设备接口回调函数。这个回调函数会...
VC++通过枚举获取系统中已安装的硬件设备
10-25
HDEVINFO hDevInfo = SetupDiGetClassDevs(&guid, NULL, NULL, DIGCF_PRESENT | DIGCF_DEVICEINTERFACE); ``` 接下来，我们需要遍历设备信息集，获取每个设备实例的详细信息。`SetupDiEnumDeviceInfo`函数用于此...
PCI驱动程序几个GUID
Builder的空间
02-24 2884
1、Device_Class_GUID包含在驱动程序中，由驱动程序注册，打开该设备文件时需要用到，位于XXXDeviceInterface.h中。2、驱动对应PCI硬件的Vendor ID、Device ID、SubVendor、SubSystem位于inf文件中。3、硬件所属的设备类型ClassGUID位于inf文件中，在安装驱动时注册。 
Device Interface GUID
tomorrowsprogress的专栏
06-24 3043
MSDN中的内容位置:　DEVICE I/O下的 Device ManagementMSDN的Windows Multimedia#include       #include       #include       #include       #include       #include       #pragma       comment(lib,"setupapi
结合设备安装类GUID和设备接口类GUID获取设备VIDPID
phenixyf的专栏
06-21 1929
http://blog.csdn.net/jhqin/article/details/6766311   前言： VID和PID常被用于厂家的软件加密，只有在系统中检测到某VID和PID的设备时，软件才能运行。因此获取某一类型设备或者全部设备的VID和PID集合至关重要。获取设备VID和PID的一般流程是通过设备接口类GUID创建设备信息集，然后从设备接口详细信息中获取设备路径，再调用
网卡guid修改_修改注册表让Surface Go的无线网卡支持频段选择
weixin_26875109的博客
01-29 2324
我的Surface Go是第一代无LTE版本，无线网卡型号是Qualcomm Atheros QCA61x4A，因为一些原因急需优先选择5GHz频段wifi的功能，因此写下本文。本文的解决方案仅能保证对Qualcomm Atheros QCA61x4A这一型号的网卡有效，对于其他同品牌不同型号的网卡甚至不同品牌的网卡，既不保证能有效果，也不保证不会蓝屏炸机，请谨慎尝试。首先给出解决方案，是个注册表...
驱动开发：内核文件读写系列函数
热门推荐
CSDN
06-09 1万+
在应用层下的文件操作只需要调用微软应用层下的`API`函数及`C库`标准函数即可，而如果在内核中读写文件则应用层的API显然是无法被使用的，内核层需要使用内核专有API，某些应用层下的API只需要增加Zw开头即可在内核中使用，例如本章要讲解的文件与目录操作相关函数，多数ARK反内核工具都具有对文件的管理功能，实现对文件或目录的基本操作功能也是非常有必要的。 首先无论在内核态还是在用户态，我们调用的文件操作函数其最终都会转换为一个IRP请求，并发送到文件系统驱动上的`IRP_MJ_READ`派遣函数里面，这
在C#中使用SetupApi获取设备的Device ID。
05-30
获取设备的 Device ID 可以使用 SetupApi 库中的 SetupDiGetDeviceInstanceId 函数来实现。 您可以按照以下步骤进行操作： 1. 引入 SetupApi 库： ```csharp using System.Runtime.InteropServices; using System.Text; ``` 2. 定义 SetupApi 函数： ```csharp [DllImport("setupapi.dll", CharSet = CharSet.Unicode)] public static extern bool SetupDiEnumDeviceInfo(IntPtr DeviceInfoSet, uint MemberIndex, ref SP_DEVINFO_DATA DeviceInfoData); [DllImport("setupapi.dll", CharSet = CharSet.Unicode)] public static extern IntPtr SetupDiGetClassDevs(ref Guid ClassGuid, string Enumerator, IntPtr hwndParent, uint Flags); [DllImport("setupapi.dll", CharSet = CharSet.Unicode)] public static extern bool SetupDiDestroyDeviceInfoList(IntPtr DeviceInfoSet); [DllImport("setupapi.dll", CharSet = CharSet.Unicode)] public static extern bool SetupDiGetDeviceInstanceId(IntPtr DeviceInfoSet, ref SP_DEVINFO_DATA DeviceInfoData, StringBuilder DeviceInstanceId, int DeviceInstanceIdSize, out int RequiredSize); ``` 3. 创建获取设备 Device ID 的方法： ```csharp public static string GetDeviceID(Guid classGuid, int index) { IntPtr deviceInfoSet = SetupApi.SetupDiGetClassDevs(ref classGuid, null, IntPtr.Zero, SetupApi.DIGCF_PRESENT | SetupApi.DIGCF_PROFILE); if (deviceInfoSet.ToInt64() == -1) { return ""; } SP_DEVINFO_DATA deviceInfoData = new SP_DEVINFO_DATA(); deviceInfoData.cbSize = Marshal.SizeOf(deviceInfoData); if (SetupApi.SetupDiEnumDeviceInfo(deviceInfoSet, (uint)index, ref deviceInfoData)) { StringBuilder deviceInstanceId = new StringBuilder(256); int requiredSize = 0; if (SetupApi.SetupDiGetDeviceInstanceId(deviceInfoSet, ref deviceInfoData, deviceInstanceId, deviceInstanceId.Capacity, out requiredSize)) { return deviceInstanceId.ToString(); } } SetupApi.SetupDiDestroyDeviceInfoList(deviceInfoSet); return ""; } ``` 4. 调用 GetDeviceID 方法： ```csharp Guid classGuid = new Guid("YOUR_DEVICE_CLASS_GUID"); int index = 0; string deviceID = GetDeviceID(classGuid, index); ``` 其中，YOUR_DEVICE_CLASS_GUID 需要替换成您想要获取 Device ID 的设备的类 GUID。您可以在设备管理器中找到设备的类 GUID。 另外，index 参数表示设备列表中设备的索引，从 0 开始。如果需要获取所有设备的 Device ID，可以使用一个循环来遍历设备列表，并调用 GetDeviceID 方法来获取每个设备的 Device ID。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值