Función KsFreeObjectCreateItemsByContext (ks.h)

  • Artículo

Libera todos los elementos de creación con un contexto específico.

Sintaxis

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

Parámetros

[in] Header

Apunta al encabezado del dispositivo en el que se adjuntan los elementos de creación.

[in] Context

Contiene el contexto de los elementos de creación que se van a liberar. Se liberarán todos los elementos de creación con este valor de contexto.

Valor devuelto

Devuelve STATUS_SUCCESS si el elemento se liberó; de lo contrario, STATUS_OBJECT_NAME_NOT_FOUND.

Comentarios

En lugar de liberar elementos por nombre como KsFreeObjectCreateItems , esta función liberará todos los elementos con un contexto específico. Por ejemplo, todos los elementos de creación asociados a un generador de filtros tendrán el generador como contexto y se pueden liberar simultáneamente con esta llamada en lugar de uno a uno. Tenga en cuenta que esta función no supone que el autor de la llamada serialice varios cambios en la lista de entradas de creación.

Requisitos

Requisito Value
Plataforma de destino Universal
Encabezado ks.h (incluye Ks.h)
Library Ks.lib

Consulte también

KsFreeObjectCreateItem