Guia de design de plug-ins de proxy de streaming de kernel

O módulo de proxy KS (kernel-streaming) (Ksproxy.ax) é um filtro DirectShow que intermedia a comunicação entre objetos KS no modo kernel e aplicativos no modo usuário. Os componentes do 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 de 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 gravadores de aplicativos um mecanismo mais familiar do que trabalhar diretamente com conjuntos de propriedades de filtro KS e pin KS.

As seções a seguir fornecem uma descrição de alto nível de como escrever um plug-in do 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ático para obter e definir valores de propriedade de dentro de um aplicativo. Como alternativa, se sua meta for permitir que os usuários manipulem propriedades por meio de uma interface do usuário, uma página de propriedades fará mais sentido. Ambos os mecanismos exigem que você atualize o registro.

Registrando plug-ins de proxy KS

Plug-in do manipulador de interface

Plug-in da página de propriedades

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