USB HOST DRIVER V03 Freescale Semiconductor / Motorola, USB HOST DRIVER V03 Datasheet - Page 21

• Manufacturer Part Number: USB HOST DRIVER V03
• Description: USB Host Driver v03
• Manufacturer: Freescale Semiconductor / Motorola

In addition the Client application must link pipe objects to a Device object. This
guarantees that
will not be blocked when this Device handle is locked by the Device. So pipe linking is a
mandatory condition to ensure pipe objects connection. The following sample illustrates
pipe linking (assumes that Device
also open):
USB_HANDLE_INFO handleInfo; // Kernel-mode handle to pipe object
// Get the opened pipe kernel-mode handle
DeviceIoControl (hPipe, IOCTL_USB_GET_HANDLE,
// Link pipe handle hPipe to Device hDevice
DeviceIoControl
sizeof(USB_HANDLE_INFO),
2.5.2.
The pipe object represents a physical channel on the Device through which data flow
transactions can be performed. The
for requests for data transactions on an opened pipe handle. The
be used to abort all outstanding transactions on a pipe object.
CloseHandle
Function Name
CreateFile
CloseHandle
WriteFile, WriteFileEx
ReadFile, ReadFileEx
CancelIO
DeviceIoControl
2.6. Attaching and Removing Notifications.
The Microsoft Windows operating system provides service routines for attaching a PnP
Device or removing handling. Several API functions can be found in the
M
Pipe Object Functions.
Table 2.3 Win32 API operations list for a pipe object.
are used for Device object connection only.
ReadFile / WriteFile
PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE
&handleInfo,
(hDevice,
Description
Creates pipe object
Closes pipe object handle
Performs data transmission to Device. Used on bulk or isochronous
OUT pipes.
Performs data transmission from Device. Used on bulk IN, interrupt
and isochronous IN pipes.
Cancels all pending input and output operations that were issued by
the calling thread for the specified pipe handle.
Performs requests on pipe object.
NULL,
hDevice
sizeof(USB_HANDLE_INFO),
ReadFile
Driver Model.
0,
to pipes that belong to the same Device handle,
IOCTL_USB_LINK_PIPE,
is already opened, and pipe handle
NULL);
and
WriteFile
NULL, NULL,
functions are responsible
CancelIO
NULL);
CreateFile
&handleInfo,
routine should
dbt.h
hPipe
header
and
2-10
is