Función DrvResetPDEV (winddi.h)
La función DrvResetPDEV permite a un controlador gráfico transferir el estado del controlador de una estructura PDEV antigua a una nueva estructura PDEV cuando una aplicación Win32 llama a ResetDC.
Sintaxis
BOOL DrvResetPDEV(
DHPDEV dhpdevOld,
DHPDEV dhpdevNew
);
Parámetros
dhpdevOld
Identificador proporcionado por el autor de la llamada a la estructura PDEV del dispositivo original. Anteriormente, el controlador proporcionó este identificador como un valor devuelto para DrvEnablePDEV.
dhpdevNew
Identificador proporcionado por el autor de la llamada a la nueva estructura PDEV.
Valor devuelto
Este valor devuelto es TRUE si la función se realiza correctamente. De lo contrario, es FALSE y se registra un código de error.
Comentarios
La función DrvResetPDEV de un controlador gráfico debe usarse para modificar el contenido de una nueva estructura PDEV, en función del contenido de la estructura PDEV anterior (actualmente en uso).
Los controladores de pantalla de OpenGL que necesitan conocer los cambios de modo deben implementar DrvResetPDEV. De lo contrario, todos los demás controladores de pantalla normalmente no necesitan implementar esta función.
Nota La siguiente información pertenece a los archivos DLL de gráficos de impresora.
Se llama a la función como resultado de la llamada de una aplicación a la función ResetDC de Win32, que a su vez hace que GDI llame a DrvEnablePDEV del controlador para obtener una nueva estructura PDEV. Dado que el controlador puede modificar el contenido de una estructura PDEV durante la representación de un trabajo de impresión, la función DrvResetPDEV permite al controlador transferir estas modificaciones de la estructura PDEV antigua a la nueva.Ejemplos de los tipos de información que es posible que un archivo DLL de gráficos de impresora quiera agregar a la nueva estructura PDEV son punteros a archivos de fuente almacenados en caché o marcas que indican si la inicialización de página debe (o no) tener lugar la próxima vez que se llame a DrvStartDoc o DrvStartPage .
Si se llama a ResetDC durante la representación de un documento de impresión, el archivo DLL de gráficos de impresora recibe la siguiente secuencia de llamadas:
dhpdevNew = DrvEnablePDEV();
DrvResetPDEV(dhpdevOld, dhpdevNew);
DrvDisableSurface(dhpdevOld);
DrvDisablePDEV(dhpdevOld);
DrvEnableSurface(dhpdevNew);
DrvStartDoc(dhpdevNew);
Si se llama a ResetDC entre documentos, no hay ninguna superficie asociada al PDEV, por lo que solo se realiza la siguiente secuencia de llamadas:
dhpdevNew = DrvEnablePDEV();
DrvResetPDEV(dhpdevOld,dhpdevNew);
DrvDisablePDEV(dhpdevOld);
Requisitos
| Plataforma de destino | Escritorio |
| Encabezado | winddi.h (incluya Winddi.h) |