KsFreeObjectCreateItemsByContext 函数 (ks.h)

  • 项目

释放具有特定上下文的所有创建项。

语法

KSDDKAPI NTSTATUS KsFreeObjectCreateItemsByContext(
  [in] KSDEVICE_HEADER Header,
  [in] PVOID           Context
);

参数

[in] Header

指向附加创建项的设备标头。

[in] Context

包含要释放的创建项的上下文。 将释放具有此上下文值的所有创建项。

返回值

如果项已释放，则返回STATUS_SUCCESS，否则返回STATUS_OBJECT_NAME_NOT_FOUND。

注解

此函数将释放具有特定上下文的所有创建项，而不是像 KsFreeObjectCreateItems 那样按名称释放创建项。 例如，与筛选器工厂关联的所有创建项都将将工厂作为上下文，并且可以与此调用同时释放，而不是一次释放一个。 请注意，此函数不假定调用方正在序列化对创建条目列表的多个更改。

要求

要求 值
目标平台 通用
标头 ks.h (包括 Ks.h)
Library Ks.lib

另请参阅

KsFreeObjectCreateItem