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

Confira também

DEVICE_OBJECT

DRIVER_OBJECT

KsFilterFactoryUpdateCacheData

KsFilterRegisterPowerCallbacks