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 |