Función DrvSaveScreenBits (winddi.h)
La función DrvSaveScreenBits hace que un controlador de pantalla guarde o restaure un rectángulo determinado de la imagen mostrada.
Sintaxis
ULONG_PTR DrvSaveScreenBits(
SURFOBJ *pso,
ULONG iMode,
ULONG_PTR ident,
RECTL *prcl
);
Parámetros
pso
Puntero a una estructura SURFOBJ que describe la superficie.
iMode
Especifica la operación que se va a realizar. Este parámetro puede establecerse con uno de los siguientes valores:
SS_SAVE
El controlador debe guardar los datos del rectángulo definido por prcl. El controlador es responsable de administrar estos datos en su memoria fuera de la pantalla. Se omite el parámetro ident .
Tras el éxito, DrvSaveScreenBits debe devolver un identificador para los datos guardados. El controlador puede devolver un identificador o incluso un puntero a su memoria fuera de la pantalla. Esta función devuelve cero si se produce un error.
SS_RESTORE
El controlador debe restaurar los datos identificados por ident en el prcl rectángulo en la pantalla; es decir, el controlador debe restaurar el mapa de bits en su posición original. El controlador puede suponer que el rectángulo en prcl es exactamente el mismo tamaño que el rectángulo que se guardó. Los datos se deben descartar después de esta llamada.
DrvSaveScreenBits debe devolver TRUE si los datos se han restaurado en la pantalla o FALSE si los datos no se pueden restaurar.
SS_FREE
Los datos identificados por ident ya no son necesarios y se pueden liberar. El valor de prcl no está definido y no se debe usar. El controlador no debe restaurar el rectángulo guardado en la pantalla.
DrvSaveScreenBits debe devolver TRUE.
ident
Puntero a un valor definido por el controlador devuelto por una llamada anterior a DrvSaveScreenBits si iMode está SS_RESTORE o SS_FREE. El controlador debe omitir este parámetro cuando se SS_SAVE iMode .
prcl
Puntero a una estructura RECTL que define la parte de la pantalla que se va a guardar o restaurar.
Valor devuelto
El valor devuelto depende del valor del parámetro iMode .
Comentarios
Algunos controladores de pantalla pueden mover datos hacia o desde la memoria del dispositivo fuera de la pantalla mucho más rápido que el área se puede volver a dibujar. Esto puede resultar útil cuando el Administrador de ventanas debe mostrar un menú o un cuadro de diálogo.
DrvSaveScreenBits es opcional para los controladores de pantalla.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | winddi.h (incluya Winddi.h) |