Função KsRegisterFilterWithNoKSPins (ks.h)
A função KsRegisterFilterWithNoKSPins registra-se com filtros DirectShow que não têm pinos de streaming de kernel e, portanto, não são transmitidos no modo kernel.
Sintaxe
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
Um ponteiro para uma estrutura de DEVICE_OBJECT correspondente ao dispositivo ao qual registrar o filtro.
[in] InterfaceClassGUID
Um ponteiro para o GUID que representa a classe a ser registrada. Por exemplo, isso apontaria para KSCATEGORY_TVTUNER para um filtro do TvTuner.
[in] PinCount
A contagem do número de pinos no filtro.
[in] PinDirection
Um ponteiro para o primeiro elemento de uma matriz de valores boolianos que indica a direção do pino para cada pino no filtro. Os pinos de saída são TRUE; Os pinos de entrada são FALSE. Essa matriz deve ser PinCount de comprimento.
[in] MediumList
Um ponteiro para o primeiro elemento de uma matriz de estruturas de KSPIN_MEDIUM definindo os meios para cada pino no filtro. Essa matriz deve ser PinCount de comprimento.
[in, optional] CategoryList
Um ponteiro para o primeiro elemento de uma matriz de GUIDs definindo as categorias para cada pino no filtro. Se esse parâmetro estiver presente, ele deverá ser PinCount de comprimento.
Retornar valor
Retorna êxito ou falha ao criar a chave FilterData no registro.
Comentários
Use KsRegisterFilterWithNoKSPins para registrar TvTuners, Barras cruzadas e componentes semelhantes. KsRegisterFilterWithNoKSPins cria uma nova chave do Registro, FilterData, que contém os meios e, opcionalmente, as categorias, para cada pino no filtro.
Essa função só é usada para registrar filtros que não têm pinos de kernel correspondentes. Se tiver êxito, KsRegisterFilterWithNoKSPins criará uma chave no Registro que pode ser usada pelo DirectShow.
Se estiver escrevendo um minidriver BDA, considere usar KsFilterFactoryUpdateCacheData em vez dessa rotina. Consulte detalhes na página de referência para KsFilterFactoryUpdateCacheData.
Para obter mais informações, consulte Descritores AVStream e Inicializando um Minidriver AVStream.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Microsoft Windows XP e em sistemas operacionais posteriores e no DirectX 8.0 e versões posteriores do DirectX. |
| Plataforma de Destino | Universal |
| Cabeçalho | ks.h (inclua Ks.h) |
| Biblioteca | Ks.lib |
| IRQL | PASSIVE_LEVEL |