ResetDC

La función ResetDC actualiza el contexto de dispositivo de una impresora o plotter dado, basándose en la información indicada en la estructura especificada.

Sintaxis

int ResetDC(
    HDC hdc,                   // manipulador de contexto de dispositivo
    CONST DEVMODE *lpInitData  // dirección de estructura con la información del contexto de dispositivo
   );

Parámetros

hdc: Identifica el contexto de dispositivo del trabajo de impresión.

lpInitData: Puntero a una estructura DEVMODE que contiene información sobre el nuevo contexto de dispositivo.

Valor de retorno

Si la función tiene éxito, el valor de retorno es el manipulador del contexto de dispositivo original.

Si la función falla, el valor de retorno es NULL.

Observaciones

El uso típico de ResetDC es cuando una ventana recibe el mensaje WM_DEVMODECHANGE. ResetDC se puede usar también para cambiar la orientación del papel o los márgenes mientras se imprime 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 cambie el puerto de conexión o el nombre del dispositivo, la aplicación debe borrar el contexto de dispositivo original y crear uno nuevo con la nueva información.

Una aplicación puede pasar una información de contexto de dispositivo a la función ResetDC. En ese caso, ResetDC siempre devolverá un contexto de dispositivo de impresora.