Compartilhar via

Função DrvAssertMode (winddi.h)

  • Artigo

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)

Confira também

DrvGetModes

DrvSetPalette