2.2.4.6 USB_DEVICE_Close Function
C
void USB_DEVICE_Close(
USB_DEVICE_HANDLE usbDeviceHandle
);
Summary
This function closes an opened handle to an instance of the USB device layer, invalidating the handle.
Precondition
The USB_DEVICE_Initialize function must have been called for the specified device layer instance. USB_DEVICE_Open must have been called to obtain a valid opened device handle.
Parameters
Parameters | Description |
usbDeviceHandle | A valid open-instance handle, returned from USB_DEVICE_Open |
Returns
After calling this routine, the handle passed in "usbDevHandle" must not be used with any of the remaining driver routines. A new handle must be obtained by calling USB_DEVICE_Open() before the client may use the device layer again.
Example
USB_DEVICE_HANDLE usbDeviceHandle; // Before opening a handle, USB device must have been initialized // by calling USB_DEVICE_Initialize(). usbDeviceHandle = USB_DEVICE_Open( USB_DEVICE_INDEX_0 ); if(USB_DEVICE_HANDLE_INVALID == usbDeviceHandle) { //Failed to open handle. } //................. //................. // User's code //................. //................. // Close handle USB_DEVICE_Close( usbDevHandle );
Remarks
None.