gst_message_get_structure

`gst_message_get_structure` 是 GStreamer 中的一个函数，用于从 `GstMessage` 中获取包含的 `GstStructure`。

`GstMessage` 是 GStreamer 中的消息类型，用于在管道中传递信息和事件。每个 `GstMessage` 都可以包含一个或多个 `GstStructure`，用于携带附加的元数据或自定义信息。

`gst_message_get_structure` 的函数签名如下：

GstStructure *gst_message_get_structure(GstMessage *message);

参数说明：
- `message`：要获取 `GstStructure` 的消息对象。

该函数返回一个指向包含在消息中的 `GstStructure` 对象的指针。如果消息未包含 `GstStructure`，则返回 `NULL`。

以下是一个示例代码，演示如何使用 `gst_message_get_structure` 获取消息中的 `GstStructure`：

// 假设有一个 GstBus 对象 bus，用于接收消息
GstMessage *message = gst_bus_pop(bus); // 从总线中获取消息

if (GST_MESSAGE_TYPE(message) == GST_MESSAGE_ELEMENT) {
  GstStructure *structure = gst_message_get_structure(message);
  if (structure != NULL) {
    const gchar *name = gst_structure_get_name(structure);
    g_print("Message structure: %s\n", name);
    // 对结构体进行进一步处理
  }
}

gst_message_unref(message); // 释放消息对象

在上面的示例中，我们从 `GstBus` 中获取一条消息，并检查该消息的类型是否为 `GST_MESSAGE_ELEMENT`。如果是，我们使用 `gst_message_get_structure` 获取消息中的 `GstStructure` 对象，并使用 `gst_structure_get_name` 获取结构体的名称进行打印。

注意，在使用完消息和结构体后，需要使用 `gst_message_unref` 来释放消息对象的引用计数。

使用 `gst_message_get_structure` 可以方便地从 `GstMessage` 中获取包含的 `GstStructure`，以进一步处理和解析消息中的元数据或自定义信息。