CLIPOBJ_cEnumStart 함수(winddi.h)

CLIPOBJ_cEnumStart 함수는 지정된 클립 영역에서 사각형을 열거하기 위한 매개 변수를 설정합니다.

구문

ENGAPI ULONG CLIPOBJ_cEnumStart(
  [in] CLIPOBJ *pco,
  [in] BOOL    bAll,
  [in] ULONG   iType,
  [in] ULONG   iDirection,
  [in] ULONG   cLimit
);

매개 변수

[in] pco

열거할 클립 영역을 정의하는 CLIPOBJ 구조체에 대한 포인터입니다.

[in] bAll

전체 지역을 열거할지 여부를 지정합니다. 전체 지역을 열거해야 하는 경우 이 매개 변수는 TRUE 입니다. 현재 그리기 작업과 관련된 부분만 열거해야 하는 경우 FALSE 입니다.

클립 영역을 캐시하는 드라이버는 전체 지역을 열거해야 합니다.

[in] iType

CLIPOBJ_bEnum 작성할 데이터 구조를 지정합니다. 현재 이 매개 변수는 영역이 사각형 목록으로 열거되어야 함을 나타내는 CT_RECTANGLES 합니다.

[in] iDirection

사각형을 열거할 순서를 결정합니다. DrvBitBlt 작업이 동일한 표면에서 동시에 실행되는 경우 이 순서는 필수적일 수 있습니다. 순서가 디바이스 드라이버와 관련이 없는 경우 GDI가 열거형을 최적화할 수 있도록 복잡한 지역에 대해 CD_ANY 지정해야 합니다. 이 값은 다음 중 하나일 수 있습니다.

값	의미
CD_ANY	GDI에 편리한 모든 주문.
CD_LEFTDOWN	오른쪽에서 왼쪽으로, 위에서 아래로.
CD_LEFTUP	오른쪽에서 왼쪽으로, 아래쪽에서 위쪽으로.
CD_RIGHTDOWN	왼쪽에서 오른쪽으로, 위에서 아래로.
CD_RIGHTUP	왼쪽에서 오른쪽으로, 아래쪽에서 위쪽으로.

[in] cLimit

열거할 최대 사각형 수를 지정합니다. 이 매개 변수가 0이면 계산이 생략됩니다.

반환 값

반환 값은 열거형 사각형의 수입니다. 개수가 cLimit를 초과하면 반환 값이 0xFFFFFFFF.

설명

이 함수가 호출되는지 여부는 지역을 열거할 수 있습니다. 기본적으로 드라이버는 왼쪽 위에서 시작하여 관련 사각형만 열거합니다.

드라이버는 이 함수를 다시 호출하여 열거형을 다시 시작할 수 있습니다.

요구 사항

지원되는 최소 클라이언트	Windows 2000 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	winddi.h(Winddi.h 포함)
라이브러리	Win32k.lib
DLL	Win32k.sys

추가 정보

CLIPOBJ

CLIPOBJ_bEnum

DrvBitBlt