usbdPipeDisconnect
Purpose
Disconnects from a device pipe.
Syntax
#include <usbdi.h>
USBstatus usbdPipeDisconnect(handle, hpipe)
USBhandle handle;
USBhandle hpipe;
Parameter
| Item | Description |
|---|---|
| handle | Handle of open USB logical device that is returned by the USBD_OPEN_DEVICE fp_ioctl. |
| hpipe | Pipes handle returned from the usbdPipeConnect function. |
Description
The USB client driver calls this function to disconnect from a device pipe. After a pipe is disconnected, the pipe handle is no longer valid and must not be used. Any I/O operations outstanding to and from the pipe is stopped when this function is called. Upon receiving this call, the USB system driver verifies the passed in client and if the pipe handles are valid, the pipe is connected. It calls the pipe disconnect function of the adapter driver to free the adapter driver-related data structures.
Execution Environment
This function might be called from the process environment only.
Return Values
| Value | Description |
|---|---|
| USBD_SUCCESS | success |
| All others | failures |