WNDOBJ_cEnumStart 함수(winddi.h)

아티클
03/13/2024

WNDOBJ_cEnumStart 함수는 창의 표시되는 영역에서 사각형 열거를 위한 매개 변수를 설정하는 콜백 함수입니다.

구문

ENGAPI ULONG WNDOBJ_cEnumStart(
  WNDOBJ *pwo,
  ULONG  iType,
  ULONG  iDirection,
  ULONG  cLimit
);

매개 변수

pwo

EngCreateWnd를 호출하여 만든 WNDOBJ 구조체에 대한 포인터입니다.

iType

WNDOBJ_bEnum 반환할 구조체의 형식을 지정합니다. 이 매개 변수는 CT_RECTANGLES 수 있습니다. 즉, 영역이 사각형 목록으로 열거됩니다.

iDirection

사각형이 반환되는 순서를 결정합니다. 이 순서는 동일한 표면에서 겹치는 DrvBitBlt 이 수행될 때 필수적일 수 있습니다. 주문이 디바이스 드라이버와 관련이 없는 경우 CD_ANY 지정해야 합니다. 이를 통해 GDI는 복잡한 지역에 대한 열거형을 최적화할 수 있습니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
CD_ANY	GDI에 편리한 모든 주문.
CD_LEFTDOWN	오른쪽에서 왼쪽으로, 위에서 아래로.
CD_LEFTUP	오른쪽에서 왼쪽으로, 아래쪽에서 위쪽으로.
CD_LEFTWARDS	왼쪽에서 오른쪽으로 세로 방향이 정의되지 않았습니다.
CD_RIGHTDOWN	왼쪽에서 오른쪽으로, 위에서 아래로.
CD_RIGHTUP	왼쪽에서 오른쪽으로, 아래쪽에서 위쪽으로.
CD_UPWARDS	아래쪽에서 위쪽으로 가로 방향이 정의되지 않았습니다.

cLimit

드라이버가 캐싱에 관심이 있는 개체의 수를 나타냅니다. GDI가 이 함수의 반환 값을 계산하는 동안 사각형 계산을 중지할 시기를 결정하는 데만 사용됩니다. cLimit가 0이면 계산이 수행되지 않습니다.

반환 값

반환 값은 이 값이 cLimit보다 작거나 같으면 열거될 개체 수의 수입니다. 개수가 cLimit보다 크면 반환 값이 0xFFFFFFFF.

설명

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

WNDOBJ_cEnumStart 호출해야 합니다.

EngCreateWnd 함수의 GDI에 제공된 드라이버 콜백 함수 또는 WNDOBJ가 지정된 그래픽 DDI 함수의 컨텍스트에서.
호출 스레드에 디바이스 잠금이 있는 경우 클라이언트 지역 변경이 발생하지 않도록 합니다.

요구 사항

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