Win32 API 以编程方式启用/禁用设备：详解 SetupDi... 函数

2024-03-20 06:17:42

使用 Win32 API 以编程方式启用/禁用设备

身处科技飞速发展的时代，设备管理变得越来越重要。随着 Windows 操作系统在设备管理方面的强大功能，程序员可以通过 Win32 API 以编程方式启用或禁用设备，实现自动化和动态控制。

先决条件

踏上这趟编程之旅之前，请确保你的系统满足以下必备条件：

Windows 操作系统
Visual Studio 或其他 C# 开发环境
基本 C# 编程知识

SetupDi... 函数的魔力

深入 Win32 API 的宝库，你会发现 SetupDi... 函数集，它们是管理设备的利器。对于禁用设备，SetupDiDisableDeviceInterface 函数闪亮登场。要启用设备，我们则使用它的孪生兄弟 SetupDiEnableDeviceInterface 函数。

代码示例：鼠标设备的开关

让我们通过一个实际示例，领略代码的魅力。本文将指导你编写一个 C# 程序，以禁用和启用鼠标设备：

// 代码示例从这里开始

// 导入必要的函数
using System;
using System.Runtime.InteropServices;

class Program
{
    // 鼠标设备的 GUID
    const string mouseClassGuid = "4D36E96F-E325-11CE-BFC1-08002BE10318";

    // 禁用设备
    [DllImport("setupapi.dll", CharSet = CharSet.Auto, SetLastError = true)]
    static extern bool SetupDiDisableDeviceInterface(HDEVINFO DeviceInfoSet, [In] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData);

    // 启用设备
    [DllImport("setupapi.dll", CharSet = CharSet.Auto, SetLastError = true)]
    static extern bool SetupDiEnableDeviceInterface(HDEVINFO DeviceInfoSet, [In] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData);

    // 获取设备信息集
    [DllImport("setupapi.dll", CharSet = CharSet.Auto, SetLastError = true)]
    static extern HDEVINFO SetupDiGetClassDevs([In] Guid ClassGuid, [In] string Enumerator, [In] IntPtr hwndParent, [In] DIGCF Flags);

    // 销毁设备信息集
    [DllImport("setupapi.dll", CharSet = CharSet.Auto, SetLastError = true)]
    static extern bool SetupDiDestroyDeviceInfoList(HDEVINFO DeviceInfoSet);

    // 枚举设备接口数据
    [DllImport("setupapi.dll", CharSet = CharSet.Auto, SetLastError = true)]
    static extern bool SetupDiEnumDeviceInterfaces(HDEVINFO DeviceInfoSet, [In] IntPtr DeviceInfoData, [In] ref Guid InterfaceClassGuid, [In] int MemberIndex, [In, Out] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData);

    // 常量定义
    const DIGCF PRESENT = 0x02;

    static void Main()
    {
        // 获取鼠标设备信息集
        HDEVINFO deviceInfoSet = SetupDiGetClassDevs(new Guid(mouseClassGuid), null, IntPtr.Zero, PRESENT);

        try
        {
            // 禁用鼠标设备
            foreach (var deviceInterfaceData in GetDeviceInterfaceDataList(deviceInfoSet))
            {
                if (SetupDiDisableDeviceInterface(deviceInfoSet, deviceInterfaceData))
                {
                    Console.WriteLine("鼠标设备已禁用。");
                }
                else
                {
                    Console.WriteLine("禁用鼠标设备失败。");
                }
            }

            // 启用鼠标设备
            foreach (var deviceInterfaceData in GetDeviceInterfaceDataList(deviceInfoSet))
            {
                if (SetupDiEnableDeviceInterface(deviceInfoSet, deviceInterfaceData))
                {
                    Console.WriteLine("鼠标设备已启用。");
                }
                else
                {
                    Console.WriteLine("启用鼠标设备失败。");
                }
            }
        }
        finally
        {
            // 销毁设备信息集
            SetupDiDestroyDeviceInfoList(deviceInfoSet);
        }
    }

    static IEnumerable<PSP_DEVICE_INTERFACE_DATA> GetDeviceInterfaceDataList(HDEVINFO deviceInfoSet)
    {
        var deviceInterfaceData = new PSP_DEVICE_INTERFACE_DATA();
        deviceInterfaceData.cbSize = Marshal.SizeOf(deviceInterfaceData);

        for (int i = 0; SetupDiEnumDeviceInterfaces(deviceInfoSet, null, ref mouseClassGuid, i, ref deviceInterfaceData); i++)
        {
            yield return deviceInterfaceData;
        }
    }
}

// 代码示例结束