gst_structure_foreach

`gst_structure_foreach` 是 GStreamer 中的一个函数，用于遍历 `GstStructure` 中的字段和值。

`GstStructure` 是 GStreamer 中的一个数据结构，用于表示媒体流的元数据。每个 `GstStructure` 包含多个字段，可以通过字段名来访问和操作这些值。

`gst_structure_foreach` 的函数签名如下：

void gst_structure_foreach(GstStructure *structure, GstStructureForeachFunc func, gpointer user_data);

参数说明：
- `structure`：要遍历的 `GstStructure`
- `func`：用于处理每个字段和值的回调函数
- `user_data`：传递给回调函数的用户数据指针

回调函数的定义如下：

void (*GstStructureForeachFunc) (const gchar *name, const GValue *value, gpointer user_data);

回调函数有三个参数：
- `name`：当前字段的名称
- `value`：当前字段对应的值
- `user_data`：传递给 `gst_structure_foreach` 的用户数据指针

使用 `gst_structure_foreach` 函数，我们可以遍历 `GstStructure` 中的所有字段和值，对它们进行处理。下面是一个示例代码：

static void print_field(const gchar *name, const GValue *value, gpointer user_data) {
  g_print("Field: %s\n", name);
  // 对当前字段和值进行处理
}

// 在某个地方调用 gst_structure_foreach
GstStructure *structure = gst_structure_new("my_structure", "field1", G_TYPE_INT, 10, "field2", G_TYPE_STRING, "Hello", NULL);
gst_structure_foreach(structure, (GstStructureForeachFunc)print_field, NULL);

在上面的示例中，我们创建了一个名为 "my_structure" 的 `GstStructure`，其中包含两个字段 "field1" 和 "field2"。然后，我们使用 `gst_structure_foreach` 遍历该结构，并将每个字段和值传递给 `print_field` 回调函数进行处理。在回调函数中，我们简单地打印出字段的名称。

通过使用 `gst_structure_foreach`，我们可以方便地遍历 `GstStructure` 中的字段和值，并对它们进行相应的操作。