Función ResetDCA (wingdi.h)

La función ResetDC actualiza el contexto de dispositivo de impresora o trazador especificado 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 del controlador de dominio original.

Si se produce un error en la función, el valor devuelto es NULL.

Observaciones

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 de ResetDC. En esa situación, ResetDC siempre devolverá un controlador de dominio de la 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 la miembro lpInitData de la estructura DEVMODE de .

Nota

El encabezado wingdi.h define ResetDC como 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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	wingdi.h (incluya Windows.h)
biblioteca de	Gdi32.lib
DLL de	Gdi32.dll

Consulte también

DEVMODE

funciones de contexto de dispositivo

Información general sobre contextos de dispositivo de

DeviceCapabilities

escape