Merge "Clarify the behavior of UsbRequest"

import dalvik.system.CloseGuard;

import java.io.FileDescriptor;

import java.nio.ByteBuffer;

/**

 * This class is used for sending and receiving data and control messages to a USB device.

    /**

     * Waits for the result of a {@link android.hardware.usb.UsbRequest#queue} operation

     * Note that this may return requests queued on multiple

     * {@link android.hardware.usb.UsbEndpoint}s.

     * When multiple endpoints are in use, {@link android.hardware.usb.UsbRequest#getEndpoint} and

     * {@link android.hardware.usb.UsbRequest#getClientData} can be useful in determining

     * how to process the result of this function.

     * <p>Note that this may return requests queued on multiple

     * {@link android.hardware.usb.UsbEndpoint}s. When multiple endpoints are in use,

     * {@link android.hardware.usb.UsbRequest#getEndpoint} and {@link

     * android.hardware.usb.UsbRequest#getClientData} can be useful in determining how to process

     * the result of this function.</p>

     * <p>Position and array offset of the request's buffer are ignored and assumed to be 0. The

     * position will be set to the number of bytes read/written.</p>

     *

     * @return a completed USB request, or null if an error occurred

     *

     * @throws IllegalArgumentException if the number of bytes read or written is more than the

     *                                  limit of the request's buffer. The number of bytes is

     *                                  determined by the {@code length} parameter of

     *                                  {@link UsbRequest#queue(ByteBuffer, int)}

     */

    public UsbRequest requestWait() {

        UsbRequest request = native_request_wait();

package android.hardware.usb;

import android.util.Log;

import com.android.internal.util.Preconditions;

import dalvik.system.CloseGuard;

import java.nio.ByteBuffer;

     */

    public boolean initialize(UsbDeviceConnection connection, UsbEndpoint endpoint) {

        mEndpoint = endpoint;

        mConnection = connection;

        mConnection = Preconditions.checkNotNull(connection);

        boolean wasInitialized = native_init(connection, endpoint.getAddress(),

                endpoint.getAttributes(), endpoint.getMaxPacketSize(), endpoint.getInterval());

    /**

     * Queues the request to send or receive data on its endpoint.

     * For OUT endpoints, the given buffer data will be sent on the endpoint.

     * For IN endpoints, the endpoint will attempt to read the given number of bytes

     * into the specified buffer.

     * If the queueing operation is successful, we return true and the result will be

     * returned via {@link android.hardware.usb.UsbDeviceConnection#requestWait}

     * <p>For OUT endpoints, the given buffer data will be sent on the endpoint. For IN endpoints,

     * the endpoint will attempt to read the given number of bytes into the specified buffer. If the

     * queueing operation is successful, we return true and the result will be returned via {@link

     * android.hardware.usb.UsbDeviceConnection#requestWait}</p>

     *

     * @param buffer the buffer containing the bytes to write, or location to store the results of a

     *               read. Position and array offset will be ignored and assumed to be 0. Limit and

     *               capacity will be ignored.

     * @param length number of bytes to read or write.

     *

     * @param buffer the buffer containing the bytes to write, or location to store

     * the results of a read

     * @param length number of bytes to read or write

     * @return true if the queueing operation succeeded

     */

    public boolean queue(ByteBuffer buffer, int length) {

        mBuffer = buffer;

        mLength = length;

        // Note: On a buffer slice we lost the capacity information about the underlying buffer,

        // hence we cannot check if the access would be a data leak/memory corruption.

        boolean result;

        if (buffer.isDirect()) {

            result = native_queue_direct(buffer, length, out);