Función DrvAssertMode (winddi.h)

  • Artículo

La función DrvAssertMode establece el modo del dispositivo físico especificado en el modo especificado cuando se inicializó el PDEV o en el modo predeterminado del hardware.

Sintaxis

BOOL DrvAssertMode(
  [in] DHPDEV dhpdev,
  [in] BOOL   bEnable
);

Parámetros

[in] dhpdev

Controle al PDEV que describe el modo de hardware que se debe establecer cuando bEnable es TRUE.

[in] bEnable

Especifica el modo en el que se va a establecer el hardware. Si este parámetro es TRUE, el controlador debe establecer el hardware en el modo original especificado por el PDEV inicializado. De lo contrario, si este parámetro es FALSE, el controlador debe establecer el hardware en su modo predeterminado para que el controlador de miniporte de vídeo pueda asumir el control.

Valor devuelto

DrvAssertMode devuelve TRUE si cambió correctamente el modo de visualización; devuelve FALSE si no pudo cambiar el modo de presentación. Se permite que un controlador devuelva FALSE desde una llamada a DrvAssertMode con bEnable establecido en FALSE. Un controlador debe devolver TRUE desde una llamada a DrvAssertMode con bEnable establecido en TRUE; es decir, un controlador no puede producir un error al habilitar un modo que se ha habilitado anteriormente.

Comentarios

GDI llama a DrvAssertMode cuando es necesario cambiar entre varios escritorios en una sola superficie de pantalla. Para cambiar de un PDEV a otro, GDI llama a DrvAssertMode con el parámetro bEnable establecido en FALSE para un PDEV y TRUE para el otro. Para revertir al PDEV original, se llama a DrvAssertMode con bEnable establecido en FALSE, seguido de otra llamada a DrvAssertMode, con bEnable establecido en TRUE y dhpdev establecido en el PDEV original.

Si el dispositivo físico está administrado por paletas, GDI llamará a DrvSetPalette para restablecer la paleta del dispositivo. A continuación, el controlador no necesita realizar un seguimiento del estado actual del puntero porque el Administrador de ventanas selecciona la forma de puntero correcta y la mueve a la posición actual. El administrador de consola garantiza que los escritorios se vuelvan a dibujar correctamente.

DrvAssertMode debe implementarse en controladores de pantalla.

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado winddi.h (incluya Winddi.h)

Consulte también

DrvGetModes

DrvSetPalette