Função DrvAssertMode (winddi.h)
A função DrvAssertMode define o modo do dispositivo físico especificado como o modo especificado quando o PDEV foi inicializado ou para o modo padrão do hardware.
Sintaxe
BOOL DrvAssertMode(
[in] DHPDEV dhpdev,
[in] BOOL bEnable
);
Parâmetros
[in] dhpdev
Manipule para o PDEV que descreve o modo de hardware que deve ser definido quando bEnable for TRUE.
[in] bEnable
Especifica o modo para o qual o hardware deve ser definido. Se esse parâmetro for TRUE, o driver deverá definir o hardware para o modo original especificado pelo PDEV inicializado. Caso contrário, se esse parâmetro for FALSE, o driver deverá definir o hardware como seu modo padrão para que o driver de miniporto de vídeo possa assumir o controle.
Retornar valor
DrvAssertMode retornará TRUE se tiver alterado com êxito o modo de exibição; retornará FALSE se não for possível alterar o modo de exibição. Um driver tem permissão para retornar FALSE de uma chamada DrvAssertMode com bEnable definido como FALSE. Um driver deve retornar TRUE de uma chamada DrvAssertMode com bEnable definido como TRUE; ou seja, um driver não pode falhar ao habilitar um modo que foi habilitado anteriormente.
Comentários
A GDI chama DrvAssertMode quando é necessário alternar entre várias áreas de trabalho em uma única superfície de exibição. Para alternar de um PDEV para outro, a GDI chama DrvAssertMode com o parâmetro bEnable definido como FALSE para um PDEV e TRUE para o outro. Para reverter para o PDEV original, DrvAssertMode é chamado com bEnable definido como FALSE, seguido por outra chamada para DrvAssertMode, com bEnable definido como TRUE e dhpdev definido como o PDEV original.
Se o dispositivo físico for gerenciado por paleta, a GDI chamará DrvSetPalette para redefinir a paleta do dispositivo. O driver não precisa controlar o estado atual do ponteiro porque o Gerenciador de Janelas seleciona a forma correta do ponteiro e a move para a posição atual. O gerenciador de console garante que as áreas de trabalho sejam redesenhadas corretamente.
DrvAssertMode deve ser implementado em drivers de exibição.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | winddi.h (inclua Winddi.h) |