Função DrvQueryPerBandInfo (winddi.h)

Uma função DrvQueryPerBandInfo da DLL de gráficos de impressora é chamada pela GDI antes de começar a desenhar uma banda para uma página física, para que o driver possa fornecer ao GDI informações específicas da banda.

Sintaxe

ULONG DrvQueryPerBandInfo(
  [in]      SURFOBJ     *pso,
  [in, out] PERBANDINFO *pbi
);

Parâmetros

[in] pso

Ponteiro fornecido pelo chamador para uma estrutura SURFOBJ que descreve a superfície de desenho.

[in, out] pbi

Ponteiro fornecido pelo chamador para uma estrutura PERBANDINFO que contém informações padrão, que a função pode substituir.

Valor retornado

A função deve retornar um dos seguintes valores:

Código de retorno	Descrição
Maior que zero	A GDI usará o conteúdo da estrutura PERBANDINFO.
Zero	A GDI ignorará o conteúdo da estrutura PERBANDINFO.
DDI_ERROR	A GDI não desenhará a banda.

Comentários

Se uma DLL de gráficos de impressora usar superfícies gerenciadas por GDI e se oferecer suporte a faixas de superfície, ela poderá, opcionalmente, fornecer uma função DrvQueryPerBandInfo . A GDI chama a função antes de renderizar cada banda.

A DLL de gráficos da impressora usa a estrutura PERBANDINFO da função para indicar se a banda anterior deve ser redesenhada e especificar que a banda deve ser dimensionada. Se uma DLL de gráficos de impressora der suporte a faixas, mas não fornecer uma função DrvQueryPerBandInfo , a GDI não repetirá ou dimensionará faixas.

A função DrvQueryPerBandInfo só é chamada durante a reprodução de arquivos EMF.

Requisitos

Plataforma de Destino	Área de Trabalho
Cabeçalho	winddi.h (inclua Winddi.h)

Confira também

DrvNextBand

DrvStartBanding