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_interrupt_transfer的用法

libusb_interrupt_transfer是一个函数，用于执行USB中断传输。它的原型如下：

int libusb_interrupt_transfer(
    struct libusb_device_handle *dev_handle,  // 设备句柄
    unsigned char endpoint,                   // 端点ID
    unsigned char *data,                      // 数据缓冲区
    int length,                               // 数据长度
    int *transferred,                         // 实际传输数据长度
    unsigned int timeout                      // 超时时间
);

参数说明：

- dev_handle：表示USB设备的句柄，可以通过libusb_open()或者libusb_open_device_with_vid_pid()函数获得；
- endpoint：表示要进行传输的USB端点，它由端点地址和方向组成；
- data：表示数据缓冲区的指针；
- length：表示数据缓冲区的长度；
- transferred：表示实际传输的数据长度，由函数返回；
- timeout：表示等待传输完成的超时时间，单位是毫秒。

函数返回值：

- 0：表示传输成功；
- 其他值：表示传输失败。

使用libusb_interrupt_transfer函数进行USB传输的步骤如下：

1. 打开USB设备并获取设备句柄；
2. 设置USB端点的方向和地址；
3. 分配数据缓冲区；
4. 调用libusb_interrupt_transfer函数进行数据传输；
5. 检查传输是否成功，并获取传输的数据长度；
6. 释放数据缓冲区；
7. 关闭USB设备。

示例代码：

#include <stdio.h>
#include <stdlib.h>
#include <libusb-1.0/libusb.h>

#define VENDOR_ID 0x1234
#define PRODUCT_ID 0x5678
#define ENDPOINT_IN 0x81
#define ENDPOINT_OUT 0x02
#define MAX_PACKET_SIZE 64

int main()
{
    libusb_device_handle *dev_handle;
    int transferred;
    unsigned char data[MAX_PACKET_SIZE];
    int ret;

    // 初始化libusb库
    ret = libusb_init(NULL);
    if (ret != 0) {
        printf("libusb_init failed: %d\n", ret);
        return -1;
    }

    // 打开USB设备并获取设备句柄
    dev_handle = libusb_open_device_with_vid_pid(NULL, VENDOR_ID, PRODUCT_ID);
    if (dev_handle == NULL) {
        printf("libusb_open_device_with_vid_pid failed\n");
        libusb_exit(NULL);
        return -1;
    }

    // 设置USB端点
    ret = libusb_claim_interface(dev_handle, 0);
    if (ret != 0) {
        printf("libusb_claim_interface failed: %d\n", ret);
        libusb_close(dev_handle);
        libusb_exit(NULL);
        return -1;
    }

    // 分配数据缓冲区
    unsigned char *buffer = (unsigned char *)malloc(MAX_PACKET_SIZE);
    if (buffer == NULL) {
        printf("malloc failed\n");
        libusb_release_interface(dev_handle, 0);
        libusb_close(dev_handle);
        libusb_exit(NULL);
        return -1;
    }

    // 向设备发送数据
    buffer[0] = 0x01;
    buffer[1] = 0x02;
    ret = libusb_interrupt_transfer(dev_handle, ENDPOINT_OUT, buffer, 2, &transferred, 1000);
    if (ret != 0) {
        printf("libusb_interrupt_transfer failed: %d\n", ret);
        free(buffer);
        libusb_release_interface(dev_handle, 0);
        libusb_close(dev_handle);
        libusb_exit(NULL);
        return -1;
    }

    // 从设备接收数据
    ret = libusb_interrupt_transfer(dev_handle, ENDPOINT_IN, data, MAX_PACKET_SIZE, &transferred, 1000);
    if (ret != 0) {
        printf("libusb_interrupt_transfer failed: %d\n", ret);
        free(buffer);
        libusb_release_interface(dev_handle, 0);
        libusb_close(dev_handle);
        libusb_exit(NULL);
        return -1;
    }

    // 输出接收到的数据
    printf("received data: ");
    for (int i = 0; i < transferred; i++) {
        printf("%02x ", data[i]);
    }
    printf("\n");

    // 释放数据缓冲区
    free(buffer);

    // 释放设备接口
    libusb_release_interface(dev_handle, 0);

    // 关闭USB设备
    libusb_close(dev_handle);

    // 退出libusb库
    libusb_exit(NULL);

    return 0;
}