Función KsFilterFactoryAddCreateItem (ks.h)

Artículo
02/07/2025

La función KsFilterFactoryAddCreateItem agrega un nuevo elemento de creación para el generador de filtros especificado.

Sintaxis

KSDDKAPI NTSTATUS KsFilterFactoryAddCreateItem(
  [in]           PKSFILTERFACTORY     FilterFactory,
  [in]           PWSTR                RefString,
  [in, optional] PSECURITY_DESCRIPTOR SecurityDescriptor,
  [in]           ULONG                CreateItemFlags
);

Parámetros

[in] FilterFactory

Puntero a una estructura de KSFILTERFACTORY que representa el generador de filtros al que se va a agregar un nuevo elemento de creación.

[in] RefString

Puntero a una cadena de texto Unicode que identifica el elemento de creación.

[in, optional] SecurityDescriptor

Este parámetro contiene opcionalmente un puntero a una estructura SECURITY_DESCRIPTOR para este tipo de objeto. Consulte Microsoft Windows SDK para obtener información sobre esta estructura. Para obtener información relacionada, vea KSOBJECT_CREATE_ITEM. Si null, no se asigna ningún descriptor.

[in] CreateItemFlags

Consulte la tabla para el miembro flags de de KSOBJECT_CREATE_ITEM.

Valor devuelto

KsFilterFactoryAddCreateItem devuelve éxito o error del intento de agregar un nuevo elemento de creación.

Observaciones

Normalmente, solo se agrega un único elemento de creación mediante el GUID de referencia proporcionado en el descriptor de filtro para el generador de filtros. Esta función permite al autor de la llamada agregar elementos de creación asociados a la factoría de filtros especificada.

Para obtener más información, vea Inicializar un minidriver avStream.

Requisitos

Requisito	Valor
cliente mínimo admitido	Disponible en Microsoft Windows XP y sistemas operativos posteriores y DirectX 8.0 y versiones posteriores de DirectX.
de la plataforma de destino de	Universal
encabezado de	ks.h (incluya Ks.h)
biblioteca de	Ks.lib