Descritores AVStream

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

Conforme mostrado em AVStream Object Hierarchy, o descritor de nível mais alto para um minidriver AVStream é o descritor de dispositivo, KSDEVICE_DESCRIPTOR.

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

Um KSFILTER_DESCRIPTOR indica quantos tipos de pinos o filtro suporta, 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 pinos descreve um tipo de pino que esse filtro pode instanciar. Você pode criar fábricas de pinos adicionais chamando KsFilterCreatePinFactory.

Normalmente, os minidrivers AVStream estabelecem 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.

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

A tabela de despacho é comum a cada um dos três principais tipos de descritores. Consulte Tabelas de despacho do AVStream.