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