Display Driver Registry Settings

9/8/2008

As seguinte informações descreve as chaves Registro para o driver exibir, adaptador exibir removível, Microsoft® ClearType® e Tela rotação.

Observação

Os valores Registro usar como padrão variam dependendo quais componentes estão incluídos no seu executar-imagem tempo. Para obter mais informações, consulte Configurações do Registro padrão.

As chaves do Registro para drivers de vídeo

Quando um executar-tempo imagem contém um driver exibir, ele é carregado pelo GWES no sistema inicialização.

Por padrão, GWES carrega um driver nomeado DDI.dll. A alteração o nome do driver exibir usar como padrão, use o HKEY_LOCAL_MACHINE\System\GDI\Drivers\Display chave Registro para substituir o nome DLL usar como padrão exibir driver.

A chave Registro deve ser colocado em seu arquivo Platform.reg.

Para os drivers exemplo fornecidos, este informações está no arquivo %_WINCEROOT%\Public\Common\OAK\Files\Common.reg e está incluídas para cada tipo exibir associado com um BSP_DISPLAY_Nome variável do ambiente.

Você pode incluir uma chave Registro que fornece informações adicionais sobre o driver. Este informações não são usadas pelo GDI, mas ele pode ser útil para aplicativos.

Este informações também podem ser úteis para o driver quando ele oferece suporte, de exemplo, múltiplo resoluções, que um usuário pode selecionar de aplicativos do Painel de controle que você fornecer. Este maiúsculas e minúsculas, o driver pôde Examine o Registro para determinar qual resolução definir quando o driver exibir carrega.

O seguinte exemplo mostra um chave do Registro para um driver nativo exibir que oferece suporte a um dispositivo exibir Color_Graphix_Voyager_PCMCIA-Based.

A chave armazena do driver de dispositivo a nativo DLL nome, tamanho da tela e intensidade da cor.

[HKEY_LOCAL_MACHINE\Drivers\Display\PCARDVGA]
    Dll="PCARDVGA.DLL"
    CxScreen=Dword:280
    CyScreen=Dword:F0
    Bpp=Dword:8

Para exibir PCI-Based controladores, informações modelo barramento PCI devem ser fornecidas. Isso é usado pelo driver de barramento PCI ao enumerar o barramento PCI e é preenchido na árvore instância do Registro, along with informações configuração.

Quando carregada por GWES, o driver exibir recebe informações instância e não deve precisar digitalizar o barramento PCI para localizar próprio ou ler informações configuração PCI do hardware.

Para obter mais informações sobre modelos PCI, consulte Driver de barramento PCI, Carregando drivers de dispositivo, e Exibir drivers e a imagem Run-Time.

Configurações do Registro do GWES

Para recuperar o valor contraste usar como padrão, GWES lê o HKEY_CURRENT_USER\ControlPanel\Keybd\Contrast chave Registro.

Durante uma operação continuar, GWES Executa o comando CONTRAST_CMD_GET seguido o comando CONTRAST_CMD_SET para que o hardware atualiza suas configurações contraste.

Implemente ambos os códigos de escape em seu driver exibir.

Durante operações suspend e continuar, vídeo quadro reserva dados podem ser perdidos se memória RAM não é ativado durante suspensão.

Como resultado, o exibição primária e outro vídeo surfaces, como bitmaps e ícones, podem parecer ser inútil após retomando operação. Para endereço esse problema, GWES oferece quatro opções que podem ser selecionadas por uma chave Registro. Você só pode escolher as configurações Registro.

A seguinte tabela mostra as subchaves selecionável Registro das HKEY_LOCAL_MACHINE\SYSTEM\GWE chave Registro.

Subchave	Valor	Descrição
"PORepaint"	dword:0	O driver exibir trata todas as ações. GWES não leva nenhuma ação e presume que o hardware mantém os dados superfície de exibição em memória RAM ou que outros fatores intervir para garantir que os dados não é perdida.
"PORepaint"	dword:1	GWES deve salvar e restaurar os bits. GWES salva o primário superfície de exibição, que reside no vídeo memória, no sistema memória que é mantida durante suspender operação. Após reiniciar, o primário superfície é restaurado. Como outras superfícies podem ser alocados no vídeo memória, operações blit cores são mais rápidos, mesmo embora o primário superfície é restaurado. Outras superfícies, como bitmaps e ícones, podem conter dados inúteis quando a Tela é atualizada. Para resolver este, conjunto PORepaint Igual a DWORD:3.
"PORepaint"	dword:2	GWES deve invalidar e repintar. GWES assume que todos os exibir superfícies residir na memória, exceptfor o primário sistema superfície, que pode estar em vídeo memória. Após reiniciar, GWES procura a lista de janelas e invalida cada. Porque as superfícies são assumidos como na memória sistema ou pelo menos em alguma forma de armazenamento voláteis, o processo invalidação restaura o conteúdo vídeo memória RAM com uma nova imagem. Esse processo pode ser lento.
"PORepaint"	dword:3	GWES invoca DRVESC_SAVEVIDEOMEM em Suspender tempo. GWES e o driver devem salvar vídeo memória. Esta opção permite que o driver para salvar outro vídeo nonprimary superfície dados, que reside no vídeo memória RAM, para alguma outra localidade. Após suspender, GWES faz uma DrvEscape chamar para recuperar o driver exibir para salvar todas as vídeo surfaces, incluindo o primário de superfície, para uma localidade voláteis (por exemplo, sistema memória RAM). Após reiniciar, GWES torna outra DrvEscape chamar para o driver exibir para restaurar o conteúdo de vídeo memória RAM. O mecanismo de armazenamento e a localidade armazenamento são as decisões de driver a exibir. GWES não salvar os dados de superfície diretamente.

As chaves do Registro para adaptadores de vídeo removível

Quando um secundário exibir adaptador é fornecido no hardware removível, such as um PC Card, o driver exibir é geralmente implementado como dois drivers:

• Um interno driver que expõe a interno DDI
• Um driver transmitir interface que expõe as interfaces transmitir

O driver transmitir deve inicializar o Registro com as chaves que permitir que ele seja detectada e carregado.

Quando o cartão PC é inserido, o Device Manager inicia uma seqüência detecção para determinar qual driver deverá serviço de cartão.

Se o cartão PC tem um identificador Plug and Play, ele é usado para determinar qual driver para carregar. Caso contrário, o Device Manager tenta as funções detecção para todos os drivers que estão instalados no sistema até que uma delas relata que ele reconheça o PC Card PC Card.

Após o driver correto está localizado, o Device Manager carrega o driver cujo nome é fornecido como a chave Registro, com a função detecção que teve êxito na detecção de PC Card.

O seguinte exemplo de código mostra como a Device Manager carrega o driver, registra seu nome arquivo dispositivo especial e chama do o driver XXX_Init (Device Manager) função.

 [HKEY_LOCAL_MACHINE\Drivers\PCMCIA\VoyagerVGA]
    Dll="VOYAGER.DLL"
    Prefix="VGA"
    Index=Dword:1

[HKEY_LOCAL_MACHINE\Drivers\PCMCIA\Detect\60]
    Dll="VOYAGER.DLL"
    Entry="DetectVGA"

Alguns aplicativos precisam chaves Registro adicionais para usar secundário exibir adaptadores. Durante inicialização, o driver deve atualização o HKEY_LOCAL_MACHINE\Drivers\Display\Active chave Registro com os informações apropriado para seu driver.

Este informações incluem detalhes sobre o interno driver DLL Nome, bem como BufferMode e Tapmode informações.

Para exibir removível adaptadores, essa inicialização deve tomar local quando o adaptador está conectado para o sistema e o Device Manager chamadas da interface de transmitir XXX_Init função.

O seguinte exemplo de código mostra como esse processo é executado.

[HKEY_LOCAL_MACHINE\Drivers\Display\Active\Voyager]
    Dll="PCARDVGA.DLL"
    BufferMode=Dword:0
    Tapmode=Dword:0

A seguinte tabela mostra a disponível quatro valores para BufferMode.

Valor	Descrição
bmNotShared	Não há nenhum comum reserva quadro.
bmTopHalf	O parte superior metade do secundário exibir é mostrado em interno do sistema a exibir LCD.
bmSquashed	Uma versão scaled-Down do secundário exibir é mostrado em interno do sistema a exibir LCD.
bmOff	Interno do sistema a exibir é desativada enquanto o driver está ativo.

A seguinte tabela mostra a disponível três valores para Tapmode.

Valor	Descrição
tmNone	O driver exibir não realiza nenhuma conversão de coordenadas tocar.
tmScaled	O driver exibir dimensiona coordenadas tocar para coincidir com o secundário resolução do exibir.
tmUndefined	O driver exibir relatórios coordenadas tocar de (0,0) mas ainda relatórios eventos tocar.

As chaves de Registro ClearType

O seguinte chaves Registro devem ser definidas como habilitar ClearType entre um OS.

Chave do registro	Descrição
HKEY_LOCAL_MACHINE\SYSTEM\GDI\ClearType	Permite que ClearType para todos os aplicativos. Um diferente de zero valor permite ClearType entre o OS.
HKEY_LOCAL_MACHINE\SYSTEM\GDI\Gamma	Define o contraste.

As chaves de registro de rotação Tela

Use o HKEY_LOCAL_MACHINE\SYSTEM\GDI\ROTATION chave Registro para definir o ângulo de rotação.

O seguinte exemplo chave do Registro mostra como definir o ângulo de rotação.

[HKEY_LOCAL_MACHINE\SYSTEM\GDI\ROTATION]
    "Angle"=dword:0

A seguinte tabela mostra os valores você pode usar na Ângulo subchave Registro.

Valor	Descrição
0	Nenhum rotação.
5A	girado 90 graus no sentido horário.
B4	girado 180 graus no sentido horário.
10E	girado 270 graus no sentido horário.

See Also

Concepts

Display Driver Development Concepts
Display Driver Escape Codes
Display Driver Extensions
Display Driver Recommendations
ClearType
Screen Rotation