libusb_free_transfer

libusb_free_transfer() 函数是用于释放 libusb_transfer 结构体以及该结构体中的缓冲区。在使用 libusb_submit_transfer() 函数提交传输请求后，需要使用 libusb_free_transfer() 函数释放传输请求结构体和缓冲区，以避免内存泄漏。该函数的函数原型如下：

void libusb_free_transfer(struct libusb_transfer *transfer);

其中，参数 transfer 是需要释放的传输请求结构体的指针。

相关问题

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_transfer结构体定义

libusb_transfer结构体是libusb库中一个重要的结构体，用于描述USB传输过程中的数据信息。其定义如下：

struct libusb_transfer {
    libusb_device_handle *dev_handle;    // 指向设备句柄的指针
    uint8_t endpoint;                   // 端点地址
    unsigned char type;                 // 传输类型
    unsigned int timeout;               // 超时时间
    unsigned char *buffer;              // 数据缓冲区指针
    int length;                         // 数据长度
    int actual_length;                  // 实际传输数据长度
    unsigned int num_iso_packets;       // 等分包数量
    struct libusb_iso_packet_descriptor iso_packet_desc[0]; // 等分包描述符数组
    void *user_data;                    // 用户数据指针
    uint8_t flags;                      // 标志位
    int status;                         // 传输状态
    int transferred;                    // 已传输数据长度
};

其中，各字段的含义如下：

- `dev_handle`：指向USB设备句柄的指针。
- `endpoint`：USB端点地址，用于指明数据传输的方向和类型。
- `type`：传输类型，包括控制传输、批量传输、中断传输和等时传输。
- `timeout`：传输超时时间，单位为毫秒。
- `buffer`：数据缓冲区指针，用于存储传输的数据。
- `length`：数据长度，即待传输数据的字节数。
- `actual_length`：实际传输数据长度，即实际传输的字节数。
- `num_iso_packets`：等分包数量，只在等时传输中有效。
- `iso_packet_desc`：等分包描述符数组，只在等时传输中有效。
- `user_data`：用户数据指针，可以用于传递自定义数据。
- `flags`：标志位，包括LIBUSB_TRANSFER_SHORT_NOT_OK、LIBUSB_TRANSFER_FREE_BUFFER等。
- `status`：传输状态，包括LIBUSB_TRANSFER_COMPLETED、LIBUSB_TRANSFER_ERROR等。
- `transferred`：已传输数据长度，即已经传输的字节数。