Descritores AVStream

Um minidriver AVStream descreve a si mesmo e os tipos de filtro compatíveis fornecendo estruturas de descritor aninhadas na chamada para KsInitializeDriver. Cada componente de chave - o dispositivo, a fábrica de filtros e a fábrica de pinos - tem um descritor associado.

Conforme mostrado na Hierarquia de Objetos AVStream, o descritor de nível mais alto para um minidriver AVStream é o descritor do dispositivo, KSDEVICE_DESCRIPTOR.

No descritor do dispositivo, o membro FilterDescriptors aponta para uma matriz de estruturas KSFILTER_DESCRIPTOR que descrevem os tipos de filtros que esse dispositivo pode criar. Os clientes AVStream podem chamar KsCreateFilterFactory para adicionar dinamicamente fábricas de filtros.

Um KSFILTER_DESCRIPTOR indica quantos tipos de pino o filtro dá suporte, as categorias KS sob as quais o filtro deve ser registrado e a topologia do filtro. Dentro de cada descritor de filtro, o minidriver fornece um ponteiro para uma matriz de estruturas KSPIN_DESCRIPTOR_EX . Cada um desses descritores de pin descreve um tipo de pino que esse filtro pode instanciar. Você pode criar fábricas de pinos adicionais chamando KsFilterCreatePinFactory.

Normalmente, os minidrivers AVStream dispõem tabelas de descritores estáticos em sua origem e chamam KsInitializeDriver para executar o trabalho de instalação. Para obter mais informações sobre como inicializar o driver, consulte Inicializando um minidriver AVStream.

Há outros tipos de descritores também, como o descritor de nó KSNODE_DESCRIPTOR, que descreve um determinado nó de topologia.

A tabela de expedição é comum a cada um dos três tipos de descritor main. Consulte Tabelas de expedição do AVStream.