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 |
|---|---|
|
A GDI usará o conteúdo da estrutura PERBANDINFO. |
|
A GDI ignorará o conteúdo da estrutura PERBANDINFO. |
|
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) |