vlc libvlc_video_set_callbacks 参数含义 应该怎么使用

`libvlc_video_set_callbacks` 是一个 libvlc 库函数，用于设置视频帧回调函数。该函数需要传入三个参数:

1. `opaque`: 一个 void 指针，用于向回调函数传递自定义数据。可以为 NULL。
2. `lock`: 一个函数指针，用于锁定视频帧的内存地址，以便后续读取或写入。该函数需要返回一个指向视频帧数据的指针，或者 NULL 表示无法锁定内存。函数原型为 `void *(*lock)(void *opaque, void **planes)`
3. `unlock`: 一个函数指针，用于解锁视频帧的内存地址，以便其他程序或线程可以继续访问该内存地址。函数原型为 `void (*unlock)(void *opaque, void *picture, void *const *planes)`
4. `display`: 一个函数指针，用于显示视频帧。函数原型为 `void (*display)(void *opaque, void *picture)`

使用该函数的步骤如下：

1. 定义一个结构体来存储视频帧回调函数所需的自定义数据。
2. 实现锁定函数、解锁函数和显示函数，并将它们传递给 `libvlc_video_set_callbacks` 函数。
3. 播放视频并等待回调函数被调用。

以下是一个示例代码：

typedef struct {
    unsigned char* pixels;
    size_t pitch;
} FrameData;

void* lock(void* opaque, void** planes)
{
    FrameData* frameData = (FrameData*)opaque;
    *planes = frameData->pixels;
    return NULL;
}

void unlock(void* opaque, void* picture, void* const* planes)
{
    // do nothing
}

void display(void* opaque, void* picture)
{
    FrameData* frameData = (FrameData*)opaque;
    // render the frame using the frame data
}

int main(int argc, char* argv[])
{
    libvlc_instance_t* vlcInstance = libvlc_new(argc, argv);
    libvlc_media_t* media = libvlc_media_new_path(vlcInstance, "path/to/video.mp4");
    libvlc_media_player_t* mediaPlayer = libvlc_media_player_new_from_media(media);
    
    FrameData frameData = {0};
    frameData.pixels = malloc(width * height * 4);
    frameData.pitch = width * 4;
    
    libvlc_video_set_callbacks(mediaPlayer, lock, unlock, display, &frameData);
    
    libvlc_media_player_play(mediaPlayer);
    
    // wait for the video to finish
    
    libvlc_media_player_release(mediaPlayer);
    libvlc_release(vlcInstance);
    
    free(frameData.pixels);
    
    return 0;
}

在这个示例中，我们定义了一个名为 `FrameData` 的结构体，用于存储视频帧的像素数据和步长。然后，我们实现了锁定函数、解锁函数和显示函数，并将它们传递给 `libvlc_video_set_callbacks` 函数。最后，我们播放视频并等待回调函数被调用。在回调函数中，我们使用 `FrameData` 结构体中的数据来渲染视频帧。