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 |