Reference code: detach standard drivers for macOS

Author: manuelbl

reference/macos/USB/usb_device.cpp

@@ -85,6 +85,22 @@ const usb_endpoint& usb_device::get_endpoint(usb_direction direction, int endpoi
     return usb_endpoint::invalid;
 }
 
+void usb_device::detach_standard_drivers() {
+    if (is_open())
+        throw usb_error("detach_standard_drivers() must not be called when the device is open", 0);
+
+    IOReturn ret = (*device_)->USBDeviceReEnumerate(device_, kUSBReEnumerateCaptureDeviceMask);
+    usb_error::check(ret, "failed to detach standard drivers");
+}
+
+void usb_device::attach_standard_drivers() {
+    if (is_open())
+        throw usb_error("attach_standard_drivers() must not be called when the device is open", 0);
+
+    IOReturn ret = (*device_)->USBDeviceReEnumerate(device_, kUSBReEnumerateReleaseDeviceMask);
+    usb_error::check(ret, "failed to attach standard drivers");
+}
+
 
 bool usb_device::is_open() const {
     return is_open_;

reference/macos/USB/usb_device.hpp

@@ -108,6 +108,32 @@ class usb_device {
      */
     const usb_interface& get_interface(int interface_number) const;
 
+    /**
+     * Detaches the standard drivers of the operating system.
+     *
+     * By detaching the standard drivers, the operating system releases the exclusive access
+     * to the device and/or its interfaces. It is relevant for USB devices implementing standard
+     * USB classes such as HID, CDC or mass storage.
+     *
+     * Executing this function requires either root privileges or the _com.apple.vm.device-access_ entitlement.
+     *
+     * This method should be called before the device is opened. After the device has been closed,
+     * `attach_standard_drivers()` should be called to restore the initial state.
+     */
+    void detach_standard_drivers();
+    
+    /**
+     * Attaches the standard drivers of the operating system.
+     *
+     * By attaching the standard drivers, the original state before `detach_standard_drivers()` was called
+     * is restored.
+     *
+     * Executing this function requires either root privileges or the _com.apple.vm.device-access_ entitlement.
+     *
+     * This method should be called after the device has been closed.
+     */
+    void attach_standard_drivers();
+    
     /**
      * Get a USB endpoint.
      *