Función GdiGetDevmodeForPage (winppi.h)

La función GdiGetDevmodeForPage devuelve estructuras DEVMODEW para las páginas especificadas y anteriores de un trabajo de impresión.

Sintaxis

BOOL GdiGetDevmodeForPage(
  HANDLE    SpoolFileHandle,
  DWORD     dwPageNumber,
  PDEVMODEW *pCurrDM,
  PDEVMODEW *pLastDM
);

Parámetros

SpoolFileHandle

Identificador de archivo de cola proporcionado por el autor de la llamada, obtenido por una llamada anterior a GdiGetSpoolFileHandle.

dwPageNumber

Número proporcionado por el autor de la llamada de la página para la que se va a devolver el contenido de DEVMODEW .

pCurrDM

Ubicación proporcionada por el autor de la llamada para recibir un puntero a una estructura DEVMODE para la página especificada por dwPageNumber.

pLastDM

Ubicación proporcionada por el autor de la llamada para recibir un puntero a una estructura DEVMODE para la página anterior a la especificada por dwPageNumber.

Valor devuelto

Si la operación se realiza correctamente, la función devuelve TRUE. De lo contrario, devuelve FALSE.

Comentarios

La función GdiGetDevmodeForPage se exporta gdi32.dll para su uso en la función PrintDocumentOnPrintProcessor de un procesador de impresión.

Antes de llamar a GdiPlayPageEMF para ejecutar las instrucciones EMF de una página, un procesador de impresión debe llamar a GdiGetDevmodeForPage para determinar si la estructura DEVMODE asociada a la página que se va a imprimir es la misma que la de la última página impresa. Si las dos estructuras DEVMODE devueltas no son idénticas, el procesador de impresión debe realizar los pasos siguientes, en orden, antes de llamar a GdiPlayPageEMF para la página:

1. Llame a GdiEndPageEMF.
2. Llame a GdiResetDCEMF, especificando el DEVMODE al que apunta pCurrDM.
3. Llame a GdiStartPageEMF.

Para obtener más información, consulte Uso de funciones GDI en procesadores de impresión.

Requisitos

Requisito	Value
Plataforma de destino	Universal
Encabezado	winppi.h (incluya Winppi.h)
Library	Gdi32.Lib
Archivo DLL	Gdi32.dll