Extending a Display Driver with the DDGPE Classes
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Este tópico descreve as etapas exigido para estender seu driver exibir Usando classes de DirectDraw Graphics Primitive Engine (DDGPE) C++. O DDGPE C++ classes estender a funcionalidade do GPE para suporte a inclusão de uma camada de abstração hardware do DirectDraw (DDHAL). Para adicionar essa funcionalidade, você precisará fazer alguns menor muda para codificar sua origem.
Para obter informações sobre o cabeçalho DDGPE básico e arquivos biblioteca, consulte Exemplos de driver do DirectDraw. Codificar a origem para DDGPE é _WINCEROOT%\Public\Common\OAK\Drivers\Display\DDGPE %.
Antes de começar, você precisa saber a localidade do seguinte:
- O arquivo compilar contendo informações ao link o driver de dispositivo para GPE.lib, geralmente chamado fontes.
- O arquivo cabeçalho que contém sua declaração de um GPE Device-specific-classe derivada.
- O arquivo codificar origem que contém o construtor da derivação de Device-specific de GPE classe, along with quaisquer outros arquivos que incluem o arquivo cabeçalho GPE.h.
- Quaisquer arquivos cabeçalho que contém a derivação específicas de dispositivo das Classe DDGPESurf.
- Quaisquer arquivos código-fonte referenciar o GPESurf classe diretamente, de exemplo, construtores para qualquer derivado classes.
Para estender um driver exibir com as classes DDGPE
Ddgpe.lib local no apropriado caminho Diretório biblioteca e pôr Ddgpe.h no apropriado caminho Diretório cabeçalho.
Faça as alterações no seu arquivo compilar a link para Ddgpe.lib, in addition to GPE.lib, que já deve existir. Depending on o ambiente compilar, talvez você precise adicionar Ddgpe.lib como uma das suas SOURCELIBS entradas, na ordem para HALInit serem exportados corretamente pelo seu vinculador.
Modificar arquivo .def do seu driver exibir para incluir HALInit. Isso vai expor o ponto de entrada para o DirectDraw.
Altere o arquivo cabeçalho definindo sua classe Device-specific para derivar diretamente do DDGPE instead of de GPE.
Faça as alterações necessárias ao seus construtores ou outras funções para acomodar essa alteração de classe base. Alterar os arquivos que incluem GPE.h para incluir Gdgpe.h.
Alterar quaisquer arquivos cabeçalho derivação a partir de GPESurf classe, esses podem ou não estar presentes no seu driver, derivar de exibir DDGPESurf.
Modificar seu codificar origem para acomodar essa alteração de classe base. Você deve ter certeza que seu codificar sempre faça referência a DDGPESurf Onde ela seria normalmente referir a GPESurf.
O primário superfície de um objeto deve ser criado como um DDGPESurf objeto, não um GPESurf WScript.Shell. DDGPE typecasts neste objeto, e o typecast falhará se o original objeto não era um DDGPESurf.
Recompile o driver exibir e testar que ele seja-se que ele ainda funciona corretamente.
Quando você verificou que ele continua a trabalho corretamente, continue o próximo tópico, Implementar a funcionalidade DDHAL.