libusb_submit_transfer

libusb_submit_transfer函数是libusb中的一个函数，用于提交一个异步传输请求，将一个传输请求提交到指定的设备端点上，并在传输完成或出错时调用回调函数进行处理。该函数的原型如下：

int libusb_submit_transfer(struct libusb_transfer *transfer);

其中，libusb_transfer结构体用于描述一个传输请求，其成员变量包括传输的方向、数据缓冲区、数据长度、超时时间、回调函数等。在调用libusb_submit_transfer函数之前，需要先对libusb_transfer结构体进行初始化，并将其相关成员变量设置为正确的值。

在调用libusb_submit_transfer函数后，libusb将会将传输请求提交到设备端点上，然后立即返回。当传输完成或出错时，libusb将会调用传输请求中指定的回调函数进行处理。在回调函数中，可以对传输结果进行处理，例如获取传输的数据、判断传输是否成功等。

相关问题

libusb_submit_transfer例子

下面是一个示例，展示如何使用libusb_submit_transfer函数提交传输：

#include <stdio.h>
#include <stdlib.h>
#include <libusb.h>

#define VENDOR_ID 0x0a5c
#define PRODUCT_ID 0x4503

#define ENDPOINT_IN 0x81
#define ENDPOINT_OUT 0x02

#define TRANSFER_SIZE 16

int main(void)
{
    libusb_device_handle *dev_handle;
    libusb_context *ctx = NULL;
    int r;

    // 初始化
    r = libusb_init(&ctx);
    if (r < 0)
    {
        fprintf(stderr, "libusb_init error: %d\n", r);
        return EXIT_FAILURE;
    }

    // 打开设备
    dev_handle = libusb_open_device_with_vid_pid(ctx, VENDOR_ID, PRODUCT_ID);
    if (dev_handle == NULL)
    {
        fprintf(stderr, "libusb_open_device_with_vid_pid error\n");
        libusb_exit(ctx);
        return EXIT_FAILURE;
    }

    // 分配传输缓冲区
    unsigned char *buffer = (unsigned char *)malloc(TRANSFER_SIZE);
    if (buffer == NULL)
    {
        fprintf(stderr, "malloc error\n");
        libusb_close(dev_handle);
        libusb_exit(ctx);
        return EXIT_FAILURE;
    }

    // 准备传输
    libusb_transfer *transfer = libusb_alloc_transfer(0);
    if (transfer == NULL)
    {
        fprintf(stderr, "libusb_alloc_transfer error\n");
        free(buffer);
        libusb_close(dev_handle);
        libusb_exit(ctx);
        return EXIT_FAILURE;
    }

    libusb_fill_bulk_transfer(transfer, dev_handle, ENDPOINT_OUT, buffer, TRANSFER_SIZE, NULL, NULL, 0);

    // 提交传输
    r = libusb_submit_transfer(transfer);
    if (r < 0)
    {
        fprintf(stderr, "libusb_submit_transfer error: %d\n", r);
        libusb_free_transfer(transfer);
        free(buffer);
        libusb_close(dev_handle);
        libusb_exit(ctx);
        return EXIT_FAILURE;
    }

    // 等待传输完成
    r = libusb_handle_events(ctx);
    if (r < 0)
    {
        fprintf(stderr, "libusb_handle_events error: %d\n", r);
        libusb_cancel_transfer(transfer);
        libusb_free_transfer(transfer);
        free(buffer);
        libusb_close(dev_handle);
        libusb_exit(ctx);
        return EXIT_FAILURE;
    }

    // 释放资源
    libusb_free_transfer(transfer);
    free(buffer);
    libusb_close(dev_handle);
    libusb_exit(ctx);
    return EXIT_SUCCESS;
}

这个示例使用libusb_open_device_with_vid_pid函数打开一个特定的USB设备，然后使用libusb_alloc_transfer函数分配一个传输结构体。

接下来，使用libusb_fill_bulk_transfer函数填充传输结构体，指定设备句柄、端点地址、缓冲区和缓冲区大小。然后，使用libusb_submit_transfer函数提交传输。

最后，使用libusb_handle_events函数等待传输完成。如果传输失败，可以使用libusb_cancel_transfer函数取消传输。

libusb_submit_transfer的返回值

libusb_submit_transfer函数的返回值是表示提交的传输请求是否成功的整数值。如果返回值大于等于0，则表示传输请求已成功提交，并返回了传输请求的标识符。如果返回值小于0，则表示传输请求提交失败，返回的值可能是以下错误码之一：

- LIBUSB_ERROR_INVALID_PARAM：传递给函数的参数无效。
- LIBUSB_ERROR_BUSY：接口或端点已经被占用。
- LIBUSB_ERROR_NO_DEVICE：没有连接的USB设备。
- LIBUSB_ERROR_NOT_SUPPORTED：不支持请求的操作。
- LIBUSB_ERROR_OVERFLOW：传输的长度超过了端点的最大包长度。
- LIBUSB_ERROR_PIPE：管道通讯错误。
- LIBUSB_ERROR_TIMEOUT：传输超时。
- LIBUSB_ERROR_OTHER：未知错误。