Função GdiGetDevmodeForPage (winppi.h)

  • Artigo

A função GdiGetDevmodeForPage retorna estruturas DEVMODEW para as páginas especificadas e anteriores de um trabalho de impressão.

Sintaxe

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

Parâmetros

SpoolFileHandle

Identificador de arquivo de spool fornecido pelo chamador, obtido por uma chamada anterior para GdiGetSpoolFileHandle.

dwPageNumber

Número fornecido pelo chamador da página para a qual o conteúdo DEVMODEW deve ser retornado.

pCurrDM

Local fornecido pelo chamador para receber um ponteiro para uma estrutura DEVMODE para a página especificada por dwPageNumber.

pLastDM

Local fornecido pelo chamador para receber um ponteiro para uma estrutura DEVMODE para a página anterior à especificada por dwPageNumber.

Retornar valor

Se a operação for bem-sucedida, a função retornará TRUE. Caso contrário, retornará FALSE.

Comentários

A função GdiGetDevmodeForPage é exportada por gdi32.dll para uso dentro da função PrintDocumentOnPrintProcessor de um processador de impressão.

Antes de chamar GdiPlayPageEMF para executar as instruções EMF de uma página, um processador de impressão deve chamar GdiGetDevmodeForPage para determinar se a estrutura DEVMODE associada à página a ser impressa é a mesma da última página impressa. Se as duas estruturas DEVMODE retornadas não forem idênticas, o processador de impressão deverá executar as seguintes etapas, em ordem, antes de chamar GdiPlayPageEMF para a página:

  1. Chame GdiEndPageEMF.
  2. Chame GdiResetDCEMF, especificando o DEVMODE apontado por pCurrDM.
  3. Chame GdiStartPageEMF.
Para obter informações adicionais, consulte Usando funções GDI em processadores de impressão.

Requisitos

Requisito Valor
Plataforma de Destino Universal
Cabeçalho winppi.h (inclua Winppi.h)
Biblioteca Gdi32.Lib
DLL Gdi32.dll