Compartilhar via


CLIPOBJ_bEnum

Windows Mobile Not SupportedWindows Embedded CE Supported

9/8/2008

Essa função enumera um lote de retângulos de uma região juntar especificado. Um chamar anterior para o CLIPOBJ_cEnumStart Determina a ordem de enumeração.

Syntax

BOOL CLIPOBJ_bEnum(
  CLIPOBJ* pco,
  ULONG cj,
  ULONG* pv
);

Parameters

  • pco
    [no] Ponteiro para um CLIPOBJ estrutura que descreve a região juntar enumerar.
  • Cj
    [no] Tamanho, em bytes, da reserva apontado pelo Vp parâmetro.
  • Vp
    [out] Ponteiro para uma reserva que recebe dados sobre a região juntar em um ENUMRECTS estrutura.

Return Value

Essa função retorna TRUE se o driver deve chamar essa função novamente para obter mais dados enumeração. Essa função retorna FALSE se a enumeração completo.

Se a pasta CLIPOBJ_bEnum função retorna TRUE com uma contagem de zero recorte retângulos, o driver deve chamar o CLIPOBJ_bEnum função novamente sem fazer qualquer ação.

Para um usuário-modo driver de impressora, essa função pode retornar DDI_ERROR.

Remarks

O seguinte exemplo de código mostra uma estrutura executar um loop para chamado essa função:

do
{
  bMore = CLIPOBJ_bEnum(pco, sizeof(buffer), &buffer.c);
  for (i = 0; i < buffer.c; i++) 
  {
    .
    .
    .
  }
} while (bMore);

Esta exemplo de código grava a reserva uma contagem dos objetos gravados de reserva.

Requirements

Header winddi.h
Library Ddi_ati_lib.lib, Ddi_flat_lib.lib, Ddi_gx_lib.lib, Ddi_mq200_lib.lib, Ddi_nop_lib.lib, Ddi_rflat_lib.lib, Ddi_rgx_lib.lib, Ddi_tvia5_lib.lib
Windows Embedded CE Windows CE 1.0 and later

See Also

Reference

GDI Functions for Display Drivers
CLIPOBJ_cEnumStart