| Previous | Next |
| kIOUSBConfigNotFound | kIOUSBNotEnoughPowerErr |
kIOUSBEndpointNotFound
The current interface has no matching endpoint
kIOUSBEndpointNotFound indicates that the requested endpoint is not available on the currently active USB interface. An endpoint address is not a device-wide handle: it is defined by endpoint descriptors associated with one interface and can vary when the device changes configuration or alternate setting. Direction and transfer type are part of the identity relevant to an I/O operation.
For this reason, retaining an endpoint number across a configuration switch is unsafe. A device may expose the same interface number with a different alternate setting, different endpoint set, or no endpoint for the operation at all. The failure is resolved by inspecting descriptors, not by incrementing a pipe index or retrying the transfer.
What to inspect
- Record the active configuration, interface number, alternate setting, endpoint address, direction, and expected transfer type.
- Parse the endpoint descriptors associated with the selected interface setting and compare them with the requested endpoint.
- Recreate pipe bindings after a configuration or alternate-setting change; old references can no longer describe the current endpoint set.
- Keep protocol endpoint selection separate from UI or device-name selection so that a reconnect cannot silently reuse an invalid pipe reference.
References
- Apple: USB devices, interfaces, and endpoint descriptors
- IOUSBFamily source: interface and pipe creation
- Apple: IOUSBFamily error codes
Looking for a different code? Search another status or error code.