GdiSetBatchLimit 함수(wingdi.h)

GdiSetBatchLimit 함수는 호출 스레드의 현재 일괄 처리에 누적될 수 있는 최대 함수 호출 수를 설정합니다. 시스템은 이 제한을 초과할 때마다 현재 일괄 처리를 플러시합니다.

구문

DWORD GdiSetBatchLimit(
  [in] DWORD dw
);

매개 변수

[in] dw

설정할 일괄 처리 제한을 지정합니다. 값 0은 기본 제한을 설정합니다. 값 1은 일괄 처리를 사용하지 않도록 설정합니다.

반환 값

함수가 성공하면 반환 값은 이전 일괄 처리 제한입니다.

함수가 실패하면 반환 값은 0입니다.

설명

부울 값을 반환하는 GDI 그리기 함수만 현재 일괄 처리에 누적될 수 있습니다. 다른 GDI 함수에 대한 호출은 현재 일괄 처리를 즉시 플러시합니다. 일괄 처리 제한을 초과하거나 GdiFlush 함수를 호출하면 현재 일괄 처리도 플러시됩니다.

시스템에서 함수 호출을 누적하면 함수는 TRUE 를 반환하여 일괄 처리 중임을 나타냅니다. 시스템에서 현재 일괄 처리를 플러시하고 함수를 두 번째로 실행하는 경우 반환 값은 함수의 성공 여부에 따라 TRUE 또는 FALSE입니다. 이 두 번째 반환 값은 GdiFlush 를 사용하여 일괄 처리를 플러시하는 경우에만 보고됩니다.

참고 일괄 처리 제한은 각 스레드에 대해 별도로 유지됩니다. 일괄 처리를 완전히 사용하지 않도록 설정하려면 각 스레드를 초기화하는 동안 GdiSetBatchLimit (1)를 호출합니다.

 

요구 사항

지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	wingdi.h(Windows.h 포함)
라이브러리	Gdi32.lib
DLL	Gdi32.dll

추가 정보

GdiFlush

GdiGetBatchLimit

그리기 및 그리기 함수

그리기 및 그리기 개요