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

DEVMODE

Funciones de contexto de dispositivo

Información general sobre contextos de dispositivo

DeviceCapabilities

Escape