Función KsRegisterFilterWithNoKSPins (ks.h)

La función KsRegisterFilterWithNoKSPins se registra con filtros DirectShow que no tienen patillas de streaming de kernel y, por lo tanto, no transmiten en modo kernel.

Sintaxis

KSDDKAPI NTSTATUS KsRegisterFilterWithNoKSPins(
  [in]           PDEVICE_OBJECT DeviceObject,
  [in]           const GUID     *InterfaceClassGUID,
  [in]           ULONG          PinCount,
  [in]           BOOL           *PinDirection,
  [in]           KSPIN_MEDIUM   *MediumList,
  [in, optional] GUID           *CategoryList
);

Parámetros

[in] DeviceObject

Puntero a una estructura de DEVICE_OBJECT correspondiente al dispositivo al que se va a registrar el filtro.

[in] InterfaceClassGUID

Puntero al GUID que representa la clase que se va a registrar. Por ejemplo, esto apuntaría a KSCATEGORY_TVTUNER para un filtro TvTuner.

[in] PinCount

Recuento del número de patillas del filtro.

[in] PinDirection

Puntero al primer elemento de una matriz de valores booleanos que indica la dirección del pin para cada patilla del filtro. Los pines de salida son TRUE; los pines de entrada son FALSE. Esta matriz debe ser PinCount en longitud.

[in] MediumList

Puntero al primer elemento de una matriz de estructuras de KSPIN_MEDIUM que definen los medios para cada patilla del filtro. Esta matriz debe ser PinCount en longitud.

[in, optional] CategoryList

Puntero al primer elemento de una matriz de GUID que definen las categorías de cada patilla del filtro. Si este parámetro está presente, debe ser PinCount en longitud.

Valor devuelto

Devuelve el éxito o el error de creación de la clave FilterData en el Registro.

Comentarios

Use KsRegisterFilterWithNoKSPins para registrar TvTuners, Crossbars y componentes similares. KsRegisterFilterWithNoKSPins crea una nueva clave del Registro, FilterData, que contiene los medios y, opcionalmente, las categorías, para cada patilla del filtro.

Esta función solo se usa para registrar filtros que no tienen patillas de kernel correspondientes. Si se ejecuta correctamente, KsRegisterFilterWithNoKSPins crea una clave en el Registro que DirectShow puede usar.

Si escribe un minidriver BDA, considere la posibilidad de usar KsFilterFactoryUpdateCacheData en lugar de esta rutina. Consulte los detalles de la página de referencia de KsFilterFactoryUpdateCacheData.

Para obtener más información, vea AvStream Descriptores e 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
IRQL	PASSIVE_LEVEL

Consulte también

DEVICE_OBJECT

DRIVER_OBJECT

KsFilterFactoryUpdateCacheData

KsFilterRegisterPowerCallbacks