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 |