LPSET_FRAME_LENGTH (Compact 2013)
3/26/2014
This function changes the universal serial bus (USB) frame length.
Syntax
typedef BOOL (* LPSET_FRAME_LENGTH)(
USB_HANDLE hDevice,
HANDLE hEvent,
USHORT uFrameLength
);
Parameters
- hDevice
[in] Handle to a USB device.
- hEvent
[in] Handle to an event to signal when the frame length reaches the target value.
- uFrameLength
[in] Desired frame length.
Return Value
TRUE indicates success. FALSE indicates failure.
Remarks
Client drivers should sparingly use this function because changing the USB frame length can affect other devices on the bus. The driver must obtain frame-control access by calling the LPTAKE_FRAME_LENGTH_CONTROL function before attempting to change the frame length. To enable devices to adjust to the new frame length, USB requires that frame-length changes occur gradually, over a period of frames, instead of abruptly jumping to the target frame length. The client driver passes in an event handle, which is signaled once the frame length has reached the target.
This function does not always set exactly the requested length.
Requirements
Header |
usbdi.h |
See Also
Reference
USB Driver Functions
LPRELEASE_FRAME_LENGTH_CONTROL
LPTAKE_FRAME_LENGTH_CONTROL