Función ResetDCA (wingdi.h)
La función ResetDC actualiza el contexto de dispositivo (DC) de la impresora o del trazador especificados mediante la información especificada.
Sintaxis
HDC ResetDCA(
[in] HDC hdc,
[in] const DEVMODEA *lpdm
);
Parámetros
[in] hdc
Identificador del controlador de dominio que se va a actualizar.
[in] lpdm
Puntero a una estructura DEVMODE que contiene información sobre el nuevo controlador de dominio.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es un identificador para el controlador de dominio original.
Si la función no se realiza correctamente, el valor devuelto es NULL.
Comentarios
Normalmente, una aplicación usará la función ResetDC cuando una ventana reciba un mensaje de WM_DEVMODECHANGE . ResetDC también se puede usar para cambiar la orientación del papel o las papeleras al imprimir un documento.
La función ResetDC no se puede usar para cambiar el nombre del controlador, el nombre del dispositivo o el puerto de salida. Cuando el usuario cambia la conexión de puerto o el nombre del dispositivo, la aplicación debe eliminar el controlador de dominio original y crear un nuevo controlador de dominio con la nueva información.
Una aplicación puede pasar un controlador de dominio de información a la función ResetDC . En esa situación, ResetDC siempre devolverá un controlador de dominio de impresora.
ICM: El perfil de color del controlador de dominio especificado por el parámetro hdc se restablecerá en función de la información contenida en el miembro lpInitData de la estructura DEVMODE .
Nota
El encabezado wingdi.h define ResetDC como un alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
Plataforma de destino | Windows |
Encabezado | wingdi.h (incluye Windows.h) |
Library | Gdi32.lib |
Archivo DLL | Gdi32.dll |
Consulte también
Funciones de contexto de dispositivo
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de