KsCopyObjectBagItems 函数 (ks.h)
KsCopyObjectBagItems 函数将所有项目从一个对象包复制到另一个对象包中。
语法
KSDDKAPI NTSTATUS KsCopyObjectBagItems(
[in] KSOBJECT_BAG ObjectBagDestination,
[in] KSOBJECT_BAG ObjectBagSource
);
参数
[in] ObjectBagDestination
KSOBJECT_BAG (等效于要向其复制项的 PVOID) 类型。
[in] ObjectBagSource
从中将项复制到 ObjectBagDestination 的KSOBJECT_BAG。
返回值
如果复制成功,则返回STATUS_SUCCESS。 否则,它将返回错误代码。 大多数情况下,这是STATUS_INSUFFICIENT_RESOURCES指示系统资源不足,无法完成复制操作。 如果返回STATUS_INSUFFICIENT_RESOURCES,则很可能部分(而不是全部)项已从 ObjectBagSource 复制到 ObjectBagDestination。
注解
请注意,两个包的互斥应保留。 如果相关对象包与筛选器或引脚相关联,请获取筛选器控件互斥体。 如果对象包属于筛选器工厂或设备,请获取设备互斥体。 有关详细信息,请参阅 AVStream 中的对象包和互斥体。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 在 Microsoft Windows XP 及更高版本的操作系统以及 DirectX 8.0 及更高版本的 DirectX 中可用。 |
目标平台 | 通用 |
标头 | ks.h (包括 Ks.h) |
Library | Ks.lib |
IRQL | PASSIVE_LEVEL |
另请参阅
KsPinGetConnectedFilterInterface