通过API实现C#对硬件的控制（一）（转）

最近在做项目的过程中，涉及到对硬件启用及禁用的功能（在指定时间段内才能启用硬件）。因为C#自身对硬件的操作基本为零，为此，搜索了一下MSDN中与设备相关的API函数。还果然就有。下面一一列举出各函数的原型及相关的说明文档。并将其转为C#代码实现。

函数一： RegisterDeviceNotification
功能：注册设备或者设备类型，在指定的窗口返回相关的信息

原型：

HDEVNOTIFY WINAPI RegisterDeviceNotification(
  __in  HANDLE hRecipient,
  __in  LPVOID NotificationFilter,
  __in  DWORD Flags
);

参考说明文档：http://msdn2.microsoft.com/en-us/library/aa363431.aspx。

转为C#后的代码为：

        [DllImport("user32.dll", CharSet = CharSet.Auto)]
        public static extern IntPtr RegisterDeviceNotification(IntPtr hRecipient, DEV_BROADCAST_DEVICEINTERFACE NotificationFilter, UInt32 Flags);
        [StructLayout(LayoutKind.Sequential)]
        public class DEV_BROADCAST_DEVICEINTERFACE
        ...{
            public int dbcc_size;
            public int dbcc_devicetype;
            public int dbcc_reserved;
        }

函数二：UnregisterDeviceNotification
功能：通过名柄，关闭指定设备的信息。(主要应用于清理非托管资源，并与RegisterDeviceNotification配对使用)

原型：

BOOL WINAPI UnregisterDeviceNotification(
  __in  HDEVNOTIFY Handle
);

参考说明文档：http://msdn2.microsoft.com/en-us/library/aa363475(VS.85).aspx。

转为C#后的代码：

        [DllImport("user32.dll", CharSet = CharSet.Auto)]
        public static extern uint UnregisterDeviceNotification(IntPtr hHandle);

函数三：SetupDiGetClassDevs
功能：获取一个指定类别或全部类别的所有已安装设备的信息。

原型：

HDEVINFO  SetupDiGetClassDevs(    IN LPGUID  ClassGuid,  OPTIONAL    IN PCTSTR  Enumerator,  OPTIONAL    IN HWND  hwndParent,  OPTIONAL    IN DWORD  Flags    );
参考说明文档：http://msdn2.microsoft.com/en-us/library/ms792959.aspx。

转为C#后的代码：

        [DllImport("setupapi.dll", SetLastError = true)]
        public static extern IntPtr SetupDiGetClassDevs(ref Guid gClass, UInt32 iEnumerator, IntPtr hParent, UInt32 nFlags);

函数四：SetupDiDestroyDeviceInfoList
功能：销毁一个设备信息集合，并且释放所有关联的内存。

原型：

WINSETUPAPI BOOL WINAPI  SetupDiDestroyDeviceInfoList(    IN HDEVINFO  DeviceInfoSet    );
参考说明文档：http://msdn2.microsoft.com/en-us/library/ms792991.aspx。

转为C#后的代码：

        [DllImport("setupapi.dll", SetLastError = true)]
        public static extern int SetupDiDestroyDeviceInfoList(IntPtr lpInfoSet);

函数五：SetupDiEnumDeviceInfo
功能：枚举指定设备信息集合的成员，并将数据放在SP_DEVINFO_DATA中。

原型：

WINSETUPAPI BOOL WINAPI  SetupDiEnumDeviceInfo(
IN HDEVINFO  DeviceInfoSet,
IN DWORD  MemberIndex,
 OUT PSP_DEVINFO_DATA  DeviceInfoData    );
参考说明文档：http://msdn2.microsoft.com/en-us/library/ms792983.aspx。

转为C#后的代码：

        [DllImport("setupapi.dll", SetLastError = true)]
        public static extern bool SetupDiEnumDeviceInfo(IntPtr lpInfoSet, UInt32 dwIndex, SP_DEVINFO_DATA devInfoData);
        /**//// <summary>
        /// 设备信息数据
    /// </summary>
        [StructLayout(LayoutKind.Sequential)]
        public class SP_DEVINFO_DATA
        ...{
            public int cbSize;
            public Guid classGuid;
            public int devInst;
            public ulong reserved;
        };

函数六：SetupDiGetDeviceRegistryProperty
功能：获取指定设备的属性。

原型：

WINSETUPAPI BOOL WINAPI  SetupDiGetDeviceRegistryProperty(
IN HDEVINFO  DeviceInfoSet,
IN PSP_DEVINFO_DATA  DeviceInfoData,
IN DWORD  Property,
OUT PDWORD  PropertyRegDataType,
OPTIONAL    OUT PBYTE  PropertyBuffer,
IN DWORD  PropertyBufferSize,
OUT PDWORD  RequiredSize  OPTIONAL    );
参考说明文档：http://msdn2.microsoft.com/en-us/library/ms792967.aspx。

转为C#后的代码：

        [DllImport("setupapi.dll", SetLastError = true)]
        public static extern bool SetupDiGetDeviceRegistryProperty(IntPtr lpInfoSet, SP_DEVINFO_DATA DeviceInfoData, UInt32 Property, UInt32 PropertyRegDataType, StringBuilder PropertyBuffer, UInt32 PropertyBufferSize, IntPtr RequiredSize);

函数七：SetupDiSetClassInstallParams
功能：停用设备。

原型：

WINSETUPAPI BOOL WINAPI
 SetupDiSetClassInstallParams(
    IN HDEVINFO  DeviceInfoSet,
    IN PSP_DEVINFO_DATA  DeviceInfoData,
    OPTIONAL    IN PSP_CLASSINSTALL_HEADER  ClassInstallParams,
    OPTIONAL    IN DWORD  ClassInstallParamsSize    );
参考说明文档：http://msdn2.microsoft.com/en-us/library/ms792876.aspx。

转为C#后的代码：

        [DllImport("setupapi.dll", SetLastError = true, CharSet = CharSet.Auto)]
        public static extern bool SetupDiSetClassInstallParams(IntPtr DeviceInfoSet, IntPtr DeviceInfoData, IntPtr ClassInstallParams, int ClassInstallParamsSize);

函数八：SetupDiCallClassInstaller
功能：启用设备。

原型：

WINSETUPAPI BOOL WINAPI
  SetupDiCallClassInstaller(
    IN DI_FUNCTION  InstallFunction,
    IN HDEVINFO  DeviceInfoSet,
    IN PSP_DEVINFO_DATA  DeviceInfoData  OPTIONAL    );
参考说明文档：http://msdn2.microsoft.com/en-us/library/ms792989.aspx。

转为C#后的代码：

        [DllImport("setupapi.dll", CharSet = CharSet.Auto)]
        public static extern Boolean SetupDiCallClassInstaller(UInt32 InstallFunction, IntPtr DeviceInfoSet, IntPtr DeviceInfoData);