Guia de Design de Plug-ins de Proxy de Kernel Streaming

O módulo de proxy kernel-streaming (KS) (Ksproxy.ax) é um filtro DirectShow que intermedeia a comunicação entre objetos KS em aplicativos de modo kernel e modo de usuário. Os componentes de modo de usuário podem usar o proxy KS para se comunicar com qualquer minidriver baseado em Ks.sys.

Especificamente, um aplicativo pode usar o módulo proxy KS para controlar e recuperar informações de objetos KS que um minidriver KS implementa. Os objetos KS incluem, por exemplo, filtros KS, pinos KS e relógios KS.

Você pode estender o proxy KS escrevendo um plug-in, que é uma interface COM que fornece métodos para acessar valores de propriedade. Uma vantagem do modelo de plug-in é que ele fornece aos desenvolvedores de aplicações um mecanismo que é mais familiar do que trabalhar diretamente com conjuntos de propriedades do pino KS e do filtro KS.

As seções a seguir fornecem uma descrição de alto nível de como escrever um plug-in de manipulador de interface ou uma página de propriedades que usa o proxy KS para se comunicar com um minidriver baseado em KS.

O plug-in de interface fornece controle programável para obter e definir valores de propriedade dentro de uma aplicação. Como alternativa, se seu objetivo é permitir que os usuários manipulem propriedades por meio de uma interface do usuário, uma página de propriedades faz mais sentido. Ambos os mecanismos exigem que você atualize o registro.

Registrando plug-ins de proxy KS

Plug-in de gestão de interface

Plug-in da página de propriedades

Para obter mais informações sobre as interfaces COM do proxy KS, funções auxiliares exportadas e estruturas usadas por aplicativos e plug-ins, consulte Kernel Streaming Proxy.