Primary Display Drivers
.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
Se sua plataforma hardware inclui um exibir, Windows Embedded CE carregará o usar como padrão, ou primário, driver exibir quando o sistema é inicializado.
Por padrão, GWES carrega um driver nomeado exibir DDI.dll.
Se o opcional HKEY_LOCAL_MACHINE\System\GDI\Drivers\Display chave Registro estiver presente, GWES carrega o driver exibir que é indicado por essa chave Registro.
Se a executar-imagem tempo inclui a funcionalidade de janelas, o Window Manager usa a reserva quadro que está com suporte, o driver exibição primária para todos os desenho na tela.
Para executar uma operação de desenho, um aplicativo deve primeiro obter um contexto dispositivo para uma janela ou o área de trabalho por chamado CreateWindow e GetDC. O contexto para dispositivo resultante é superfície de desenho do aplicativo.
Se a executar-imagem tempo não inclui suporte para janelas e, como resultado, tem não Window Manager, o aplicativo deve chamar Erro com o nome do arquivo DLL do driver de exibição primária para criar um contexto dispositivo diretamente.
A seguinte seqüência de etapas mostra o processo de conectar-se e desconectando de dispositivos:
O Erro função fornece a única maneira que GDI permite que um aplicativo para criar uma conexão para um gráfico dispositivo. Ele também chama funções inicialização do driver. O contexto para dispositivo retornado de chamadas, such as BeginPaint e GetDC ter sido criado pelo Window Manager por chamado Erro.
A seguinte tabela mostra inicialização funções do driver.Função Descrição Essa função passa uma matriz de função ponteiros para GWES.dll. Ele também deve copiar o GWES funções suporte para que o driver possa get o conjunto básico de Serviços suporte fornecidos pelo GWES para gráfico de drivers.
Essa função é chamado apenas depois que, quando o driver estiver primeiro carregado.
Essa função é chamado cada tempo um contexto dispositivo é criado.
Há um mapeamento um-para-um entre chamadas API para Erro e GWES chama para DrvEnablePDEV.
Depois que um aplicativo se conecta a um driver exibir e são as chamadas para inicialização função do driver de completo, você pode consulta, definir atributos e desenhar, conforme explicado na seguinte tabela.
Tarefa Descrição Consultando
A tarefa mais importante que executa um aplicativo está consultando.
De exemplo, o aplicativo deve determinar os seguinte itens:
- O tamanho da área de desenho antes ele desenha
- Quais fontes estão disponível antes ele desenha texto
- O suporte cor antes ele desenha uma fotografia
Grande parte este informações provenientes de gráfico driver.
GetDeviceCaps é uma função importante consulta. Ele permite que um aplicativo para exibição de GDIINFOestrutura, uma estrutura retornada pelo driver de elementos gráficos para GDI durante inicialização contexto dispositivo.
O driver retorna essa estrutura quando o DrvEnablePDEV função é chamado.
Configuração de atributos
Aplicativos definir atributos, que envolve decidir qual fonte usar ao desenho texto e qual cor usar para desenhar o texto.
Um intervalo grande do atributo-funções configuração está disponível.
Nenhum desses resultar em chamadas para o driver; Em vez disso, GWES envia a chave valores atributo para o driver durante as chamadas de desenho.
Desenho
Cada API - nível desenho função resultados em um chamar para um driver - nível função.
Mapeamento de API - para - chamadas função DDI podem ajudar a garantir você compreender o propósito de cada driver-nível função.
Neste exemplo, chamadas para o Polilinha Chamadas função tornam-se para DrvStrokePathDentro de driver.
- O tamanho da área de desenho antes ele desenha
Depois que você completo consultando, configuração atributos e desenho, você pode desconectar o aplicativo de dispositivo.
A seguinte tabela mostra as funções necessárias para um aplicativo para desconectar um dispositivo.Função Descrição Esta API-nível função é a duplicata para Erro.
Esta DDI-nível função é a duplicata para DrvEnablePDEV.
See Also
Reference
BitBlT Emulation Library Functions
Concepts
Display Driver Extensions
Display Driver Samples
Secondary Display Drivers
DDI Functions
GPE Base Classes
GDI Support Services
Display Buffer Formats
Line Drawing
Display Driver Escape Codes
Display Drivers and the Run-Time Image