/// <summary> /// Call HID functions that use Win32 API functions to locate a HID-class device /// by its Vendor ID and Product ID. Open a handle to the device. /// </summary> /// /// <returns> /// True if the device is detected, False if not detected. /// </returns> private Boolean FindTheHid() { var devicePathName = new String[128]; String myDevicePathName = ""; try { _deviceHandleObtained = false; CloseCommunications(); _myVendorId = 0x16c0; _myProductId = 0x05df; // Get the HID-class GUID. Guid hidGuid = _myHid.GetHidGuid(); // Fill an array with the device path names of all attached HIDs. Boolean availableHids = _myDeviceManagement.FindDeviceFromGuid(hidGuid, ref devicePathName); // If there is at least one HID, attempt to read the Vendor ID and Product ID // of each device until there is a match or all devices have been examined. if (availableHids) { Int32 memberIndex = 0; do { // Open the handle without read/write access to enable getting information about any HID, even system keyboards and mice. _hidHandle = _myHid.OpenHandle(devicePathName[memberIndex], false); if (!_hidHandle.IsInvalid) { // The returned handle is valid, // so find out if this is the device we're looking for. //_myHid.DeviceAttributes.Size = Marshal.SizeOf(_myHid.DeviceAttributes); Boolean success = _myHid.GetAttributes(_hidHandle, ref _myHid.DeviceAttributes); if (success) { //Debug.WriteLine(" HIDD_ATTRIBUTES structure filled without error."); //Debug.WriteLine(" Structure size: " + _myHid.DeviceAttributes.Size); //Debug.WriteLine(" Vendor ID: " + Convert.ToString(_myHid.DeviceAttributes.VendorID, 16)); //Debug.WriteLine(" Product ID: " + Convert.ToString(_myHid.DeviceAttributes.ProductID, 16)); //Debug.WriteLine(" Version Number: " + Convert.ToString(_myHid.DeviceAttributes.VersionNumber, 16)); if ((_myHid.DeviceAttributes.VendorID == _myVendorId) && (_myHid.DeviceAttributes.ProductID == _myProductId)) { //Debug.WriteLine(" Handle obtained to my device"); // Display the information in form's list box. //InfoBox.Text += "\nHandle obtained to my device:"; InfoBox.Text = " VID=" + Convert.ToString(_myHid.DeviceAttributes.VendorID, 16); InfoBox.Text += " PID=" + Convert.ToString(_myHid.DeviceAttributes.ProductID, 16); _deviceHandleObtained = true; myDevicePathName = devicePathName[memberIndex]; } else { // It's not a match, so close the handle. _deviceHandleObtained = false; _hidHandle.Close(); } } else { // There was a problem retrieving the information. //Debug.WriteLine(" Error in filling HIDD_ATTRIBUTES structure."); _deviceHandleObtained = false; _hidHandle.Close(); } } // Keep looking until we find the device or there are no devices left to examine. memberIndex = memberIndex + 1; }while (!((_deviceHandleObtained || (memberIndex == devicePathName.Length)))); } if (_deviceHandleObtained) { // The device was detected. // Learn the capabilities of the device. _myHid.Capabilities = _myHid.GetDeviceCapabilities(_hidHandle); // Find out if the device is a system mouse or keyboard. _hidUsage = _myHid.GetHidUsage(_myHid.Capabilities); //Close the handle and reopen it with read/write access. _hidHandle.Close(); _hidHandle = _myHid.OpenHandle(myDevicePathName, true); if (_hidHandle.IsInvalid) { InfoBox.Text += "The device is a system " + _hidUsage + "."; } else { if (_myHid.Capabilities.InputReportByteLength > 0) { // Set the size of the Input report buffer. var inputReportBuffer = new Byte[_myHid.Capabilities.InputReportByteLength]; _deviceData = new FileStream(_hidHandle, FileAccess.Read | FileAccess.Write, inputReportBuffer.Length, false); inputReportBuf = new Byte[_myHid.Capabilities.InputReportByteLength]; } if (_myHid.Capabilities.OutputReportByteLength > 0) { Byte[] outputReportBuffer = null; } // Flush any waiting reports in the input buffer. (optional) _myHid.FlushQueue(_hidHandle); } ErrorBox.Text = ""; } else { ErrorBox.Text = "Device not found."; } return(_deviceHandleObtained); } catch (Exception ex) { DisplayException(Name, ex); throw; } }
/// <summary> /// Uses a series of API calls to locate a HID-class device /// by its Vendor ID and Product ID. /// Fills myDevicePathName with a path to device found, readHandle and writeHandle. Registers for Device Notifications (attached / detached type of events). /// </summary> /// /// <returns> /// True if the device is detected, False if not detected. /// </returns> private Boolean FindTheHid(Int32 myVendorID, Int32 myProductID) { Boolean someHidDevicesFound = false; String[] devicePathName = new String[128]; String functionName = ""; Guid hidGuid = Guid.Empty; Int32 memberIndex = 0; Boolean success = false; try { myDeviceDetected = false; Tracer.Trace(string.Format("FindTheHid(0x{0:X04}, 0x{1:X04})", myVendorID, myProductID)); // *** // API function: 'HidD_GetHidGuid // Purpose: Retrieves the interface class GUID for the HID class. // Accepts: 'A System.Guid object for storing the GUID. // *** Hid.HidD_GetHidGuid(ref hidGuid); functionName = "GetHidGuid"; Tracer.Trace(MyDebugging.ResultOfAPICall(functionName)); Tracer.Trace(" GUID for system HIDs: " + hidGuid.ToString()); // Fill an array with the device path names of all attached HIDs. someHidDevicesFound = MyDeviceManagement.FindDeviceFromGuid(hidGuid, ref devicePathName); // If there is at least one HID, attempt to read the Vendor ID and Product ID // of each device until there is a match or all devices have been examined. // // Fill myDevicePathName with a path to device found. if (someHidDevicesFound) { memberIndex = 0; // Tracer.Trace(" total number of HID devices: " + devicePathName.Length); // will be something like 128, a lot of empty paths there. do { // *** // API function: // CreateFile // Purpose: // Retrieves a handle to a device. // Accepts: // A device path name returned by SetupDiGetDeviceInterfaceDetail // The type of access requested (read/write). // FILE_SHARE attributes to allow other processes to access the device while this handle is open. // A Security structure or IntPtr.Zero. // A creation disposition value. Use OPEN_EXISTING for devices. // Flags and attributes for files. Not used for devices. // Handle to a template file. Not used. // Returns: a handle without read or write access. // This enables obtaining information about all HIDs, even system // keyboards and mice. // Separate handles are used for reading and writing. // *** if (!string.IsNullOrEmpty(devicePathName[memberIndex])) { Tracer.Trace(" trying HID device path '" + devicePathName[memberIndex] + "'"); hidHandle = FileIO.CreateFile(devicePathName[memberIndex], 0, FileIO.FILE_SHARE_READ | FileIO.FILE_SHARE_WRITE, IntPtr.Zero, FileIO.OPEN_EXISTING, 0, 0); functionName = "CreateFile"; Tracer.Trace(MyDebugging.ResultOfAPICall(functionName)); Tracer.Trace(" FindTheHid(): some HID device found, returned handle: " + hidHandle.ToString()); if (!hidHandle.IsInvalid) { // The returned handle is valid, // so find out if this is the device we're looking for. // Set the Size property of DeviceAttributes to the number of bytes in the structure. MyHid.DeviceAttributes.Size = Marshal.SizeOf(MyHid.DeviceAttributes); // *** // API function: // HidD_GetAttributes // Purpose: // Retrieves a HIDD_ATTRIBUTES structure containing the Vendor ID, // Product ID, and Product Version Number for a device. // Accepts: // A handle returned by CreateFile. // A pointer to receive a HIDD_ATTRIBUTES structure. // Returns: // True on success, False on failure. // *** success = Hid.HidD_GetAttributes(hidHandle, ref MyHid.DeviceAttributes); if (success) { Tracer.Trace(" HIDD_ATTRIBUTES structure filled without error."); Tracer.Trace(" Structure size: " + MyHid.DeviceAttributes.Size); Tracer.Trace(string.Format(" Vendor ID: 0x{0:X04}", MyHid.DeviceAttributes.VendorID)); Tracer.Trace(string.Format(" Product ID: 0x{0:X04}", MyHid.DeviceAttributes.ProductID)); Tracer.Trace(string.Format(" Version Number: 0x{0:X04}", MyHid.DeviceAttributes.VersionNumber)); // Find out if the device matches the one we're looking for. if ((MyHid.DeviceAttributes.VendorID == myVendorID) && (MyHid.DeviceAttributes.ProductID == myProductID)) { Tracer.Trace(" My device detected"); myDeviceDetected = true; // Save the DevicePathName for OnDeviceChange(). myDevicePathName = devicePathName[memberIndex]; } else { // It's not a match, so close the handle. Tracer.Trace(" (This is not My Device)"); myDeviceDetected = false; hidHandle.Close(); } } else { // There was a problem in retrieving the information. Tracer.Trace(" Error in filling HIDD_ATTRIBUTES structure."); myDeviceDetected = false; hidHandle.Close(); } } } // Keep looking until we find the device or there are no devices left to examine. memberIndex = memberIndex + 1; }while (!((myDeviceDetected || (memberIndex == devicePathName.Length)))); } if (myDeviceDetected) { // The device was detected. // Register to receive notifications if the device is removed or attached. success = MyDeviceManagement.RegisterForDeviceNotifications(myDevicePathName, WindowHandle, hidGuid, ref deviceNotificationHandle); Tracer.Trace("RegisterForDeviceNotifications = " + success); // Learn the capabilities of the device. MyHid.Capabilities = MyHid.GetDeviceCapabilities(hidHandle); if (success) { // Find out if the device is a system mouse or keyboard. hidUsage = MyHid.GetHidUsage(MyHid.Capabilities); // Get the Input report buffer size. GetInputReportBufferSize(); // Get handles to use in requesting Input and Output reports. readHandle = FileIO.CreateFile(myDevicePathName, FileIO.GENERIC_READ, FileIO.FILE_SHARE_READ | FileIO.FILE_SHARE_WRITE, IntPtr.Zero, FileIO.OPEN_EXISTING, FileIO.FILE_FLAG_OVERLAPPED, 0); functionName = "CreateFile, ReadHandle"; Tracer.Trace(MyDebugging.ResultOfAPICall(functionName)); Tracer.Trace(" FindTheHid(): success, returned handle: " + readHandle.ToString()); if (readHandle.IsInvalid) { exclusiveAccess = true; Tracer.Error("The device is a system " + hidUsage + ". Applications can access Feature reports only."); } else { writeHandle = FileIO.CreateFile(myDevicePathName, FileIO.GENERIC_WRITE, FileIO.FILE_SHARE_READ | FileIO.FILE_SHARE_WRITE, IntPtr.Zero, FileIO.OPEN_EXISTING, 0, 0); functionName = "CreateFile, WriteHandle"; Tracer.Trace(MyDebugging.ResultOfAPICall(functionName)); Tracer.Trace(" FindTheHid(): handle valid, returned handle: " + writeHandle.ToString()); // Flush any waiting reports in the input buffer. (optional) MyHid.FlushQueue(readHandle); } } } else { // The device wasn't detected. Tracer.Error(string.Format("My Device not found - need a HID with vendorId={0}, productId={1}.", vendorId, productId)); } return(myDeviceDetected); } catch (Exception ex) { Tracer.Error(ex); throw; } }
/// <summary> /// Uses a series of API calls to locate a HID-class device /// by its Vendor ID and Product ID. /// </summary> /// /// <returns> /// True if the device is detected, False if not detected. /// </returns> public static Boolean FindTheHid( int myVendorID , int myProductID , ref IntPtr FrmMyHandle , ref IntPtr deviceNotificationHandle , ref Boolean exclusiveAccess , ref String hidUsage , ref Boolean myDeviceDetected , ref String myDevicePathName , ref FileStream fileStreamDeviceData , ref SafeFileHandle hidHandle , ref DeviceManagement MyDeviceManagement , ref Hid MyHid , ref string message , ref string txtInputReportBufferSize ) { Boolean deviceFound = false; String[] devicePathName = new String[128]; Guid hidGuid = Guid.Empty; Int32 memberIndex = 0; //Int32 myProductID = 0; //Int32 myVendorID = 0; Boolean success = false; try { myDeviceDetected = false; CloseCommunications( ref myDeviceDetected , ref fileStreamDeviceData , ref hidHandle ); // Get the device's Vendor ID and Product ID //myVendorID = Main.CardReader_VID; //myProductID = Main.CardReader_PID; // *** // API function: 'HidD_GetHidGuid // Purpose: Retrieves the interface class GUID for the HID class. // Accepts: 'A System.Guid object for storing the GUID. // *** Hid.HidD_GetHidGuid(ref hidGuid); // Fill an array with the device path names of all attached HIDs. deviceFound = MyDeviceManagement.FindDeviceFromGuid(hidGuid, ref devicePathName); // If there is at least one HID, attempt to read the Vendor ID and Product ID // of each device until there is a match or all devices have been examined. if (deviceFound) { memberIndex = 0; do { // *** // API function: // CreateFile // Purpose: // Retrieves a handle to a device. // Accepts: // A device path name returned by SetupDiGetDeviceInterfaceDetail // The type of access requested (read/write). // FILE_SHARE attributes to allow other processes to access the device while this handle is open. // A Security structure or IntPtr.Zero. // A creation disposition value. Use OPEN_EXISTING for devices. // Flags and attributes for files. Not used for devices. // Handle to a template file. Not used. // Returns: a handle without read or write access. // This enables obtaining information about all HIDs, even system // keyboards and mice. // Separate handles are used for reading and writing. // *** // Open the handle without read/write access to enable getting information about any HID, even system keyboards and mice. hidHandle = FileIO.CreateFile(devicePathName[memberIndex], 0, FileIO.FILE_SHARE_READ | FileIO.FILE_SHARE_WRITE, IntPtr.Zero, FileIO.OPEN_EXISTING, 0, 0); if (!hidHandle.IsInvalid) { // The returned handle is valid, // so find out if this is the device we're looking for. // Set the Size property of DeviceAttributes to the number of bytes in the structure. MyHid.DeviceAttributes.Size = Marshal.SizeOf(MyHid.DeviceAttributes); // *** // API function: // HidD_GetAttributes // Purpose: // Retrieves a HIDD_ATTRIBUTES structure containing the Vendor ID, // Product ID, and Product Version Number for a device. // Accepts: // A handle returned by CreateFile. // A pointer to receive a HIDD_ATTRIBUTES structure. // Returns: // True on success, False on failure. // *** success = Hid.HidD_GetAttributes(hidHandle, ref MyHid.DeviceAttributes); if (success) { // Find out if the device matches the one we're looking for. if ((MyHid.DeviceAttributes.VendorID == myVendorID) && (MyHid.DeviceAttributes.ProductID == myProductID)) { // Display the information in form's list box. message = "was found."; myDeviceDetected = true; // Save the DevicePathName for OnDeviceChange(). myDevicePathName = devicePathName[memberIndex]; } else { // It's not a match, so close the handle. myDeviceDetected = false; hidHandle.Close(); } } else { // There was a problem in retrieving the information. //Debug.WriteLine(" Error in filling HIDD_ATTRIBUTES structure."); myDeviceDetected = false; hidHandle.Close(); } } // Keep looking until we find the device or there are no devices left to examine. memberIndex = memberIndex + 1; }while (!((myDeviceDetected || (memberIndex == devicePathName.Length)))); } if (myDeviceDetected) { // The device was detected. // Register to receive notifications if the device is removed or attached. success = MyDeviceManagement.RegisterForDeviceNotifications(myDevicePathName, FrmMyHandle, hidGuid, ref deviceNotificationHandle); // Learn the capabilities of the device. MyHid.Capabilities = MyHid.GetDeviceCapabilities(hidHandle); if (success) { // Find out if the device is a system mouse or keyboard. hidUsage = MyHid.GetHidUsage(MyHid.Capabilities); // Get the Input report buffer size. GetInputReportBufferSize( ref exclusiveAccess , ref hidHandle , ref MyHid , ref txtInputReportBufferSize ); //Close the handle and reopen it with read/write access. hidHandle.Close(); hidHandle = FileIO.CreateFile(myDevicePathName, FileIO.GENERIC_READ | FileIO.GENERIC_WRITE, FileIO.FILE_SHARE_READ | FileIO.FILE_SHARE_WRITE, IntPtr.Zero, FileIO.OPEN_EXISTING, 0, 0); if (hidHandle.IsInvalid) { exclusiveAccess = true; } else { if (MyHid.Capabilities.InputReportByteLength > 0) { // Set the size of the Input report buffer. Byte[] inputReportBuffer = null; inputReportBuffer = new Byte[MyHid.Capabilities.InputReportByteLength]; fileStreamDeviceData = new FileStream(hidHandle, FileAccess.Read | FileAccess.Write, inputReportBuffer.Length, false); } if (MyHid.Capabilities.OutputReportByteLength > 0) { Byte[] outputReportBuffer = null; outputReportBuffer = new Byte[MyHid.Capabilities.OutputReportByteLength]; } // Flush any waiting reports in the input buffer. (optional) MyHid.FlushQueue(hidHandle); } } } else { // The device wasn't detected. myDeviceDetected = false; message = "not found."; } return(myDeviceDetected); } catch (Exception ex) { DisplayException("FindTheHid", ex); //throw; } return(false); }