Compartilhar via


Função GdiStartDocEMF (winppi.h)

A função GdiStartDocEMF executa operações de inicialização para um trabalho de impressão formatado em EMF.

Sintaxe

BOOL GdiStartDocEMF(
  HANDLE   SpoolFileHandle,
  DOCINFOW *pDocInfo
);

Parâmetros

SpoolFileHandle

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

pDocInfo

Ponteiro fornecido pelo chamador para uma estrutura DOCINFOW (descrito na documentação do SDK do Microsoft Window).

Retornar valor

Se a operação for bem-sucedida, a função retornará TRUE. Caso contrário, a função retornará FALSE e um código de erro poderá ser obtido chamando GetLastError.

Comentários

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

A função executa inicializações que devem ocorrer antes que os registros EMF de um trabalho de impressão possam ser reproduzidos. A função chama a função StartDoc do spooler (descrita na documentação do SDK da Janela), que, por sua vez, chama a função DrvStartDoc do driver de impressora.

O processador de impressão deve definir o membro lpszOutput da estrutura DOCINFOW como o nome do arquivo de saída contido na estrutura PRINTPROCESSOROPENDATA , recebida anteriormente pela função OpenPrintProcessor .

O processador de impressão deve definir o membro lpszDocName da estrutura DOCINFOW como o ponteiro de nome do documento, recebido anteriormente pela função PrintDocumentOnPrintProcessor .

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

Confira também

GdiEndDocEMF