Función KsFilterFactoryAddCreateItem (ks.h)
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 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 de SECURITY_DESCRIPTOR para este tipo de objeto. Consulte el Microsoft Windows SDK Para obtener información sobre esta estructura. Para obtener información relacionada, consulte KSOBJECT_CREATE_ITEM. Si es NULL, no se asigna ningún descriptor.
[in] CreateItemFlags
Consulte la tabla para el miembro Flags de KSOBJECT_CREATE_ITEM.
Valor devuelto
KsFilterFactoryAddCreateItem devuelve el éxito o error del intento de agregar un nuevo elemento de creación.
Comentarios
Normalmente, solo se agrega un solo 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 al generador de filtros especificado.
Para obtener más información, consulte Inicialización de un minidriver AVStream.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Microsoft Windows XP y sistemas operativos posteriores y DirectX 8.0 y versiones posteriores de DirectX. |
| Plataforma de destino | Universal |
| Encabezado | ks.h (incluya Ks.h) |
| Library | Ks.lib |
Consulte también
KsAddObjectCreateItemToDeviceHeader