Função DrvStartBanding (winddi.h)
A função DrvStartBanding é chamada pela GDI quando está pronta para começar a enviar faixas de uma página física para o driver para renderização.
Sintaxe
BOOL DrvStartBanding(
[in] SURFOBJ *pso,
[in] POINTL *pptl
);
Parâmetros
[in] pso
Ponteiro fornecido pelo chamador para uma estrutura SURFOBJ , que identifica a superfície de faixa.
[in] pptl
Ponteiro fornecido pelo chamador para uma estrutura POINTL para receber a origem fornecida pela função da primeira banda.
Retornar valor
Se a operação for bem-sucedida, a função deverá retornar TRUE. Caso contrário, ele deverá chamar a função SetLastError do Win32 para definir um código de erro e retornar FALSE.
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 deverá fornecer uma função DrvNextBand . A GDI chamará DrvStartBanding somente se a função DrvEnableSurface da DLL de gráficos da impressora anteriormente chamada EngMarkBandingSurface especificar uma superfície de faixa.
A finalidade da função DrvStartBanding é permitir que a DLL de elementos gráficos da impressora execute as inicializações necessárias antes que as operações de faixa comecem em uma página física e forneça gdi com os índices da origem da primeira banda.
A função DrvStartBanding é chamada uma vez por página. Cada vez que a GDI termina de desenhar uma banda, ela chama DrvNextBand para que o driver possa enviar a banda para a impressora.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | winddi.h (inclua Winddi.h) |