GetRegionData 함수(wingdi.h)
GetRegionData 함수는 지정된 버퍼를 지역을 설명하는 데이터로 채웁니다. 이 데이터에는 지역을 구성하는 사각형의 차원이 포함됩니다.
구문
DWORD GetRegionData(
[in] HRGN hrgn,
[in] DWORD nCount,
[out] LPRGNDATA lpRgnData
);
매개 변수
[in] hrgn
지역에 대한 핸들입니다.
[in] nCount
lpRgnData 버퍼의 크기(바이트)입니다.
[out] lpRgnData
정보를 수신하는 RGNDATA 구조체에 대한 포인터입니다. 영역의 차원은 논리 단위입니다. 이 매개 변수가 NULL인 경우 반환 값에는 지역 데이터에 필요한 바이트 수가 포함됩니다.
반환 값
함수가 성공하고 nCount 가 적절한 바이트 수를 지정하는 경우 반환 값은 사용된 실제 바이트 수( nCount보다 작거나 같음)와 같습니다.
lpRgnData가 NULL인 경우 반환 값은 필요한 바이트 수입니다.
함수가 실패하면 반환 값은 0입니다.
hrgn이 잘못되어 오류가 발생하면 GetLastError는 ERROR_INVALID_HANDLE 반환합니다. 그렇지 않으면 GetLastError 는 ERROR_INVALID_PARAMETER 반환합니다.
nCount가 너무 작으면 함수가 실패합니다.
설명
GetRegionData 함수는 ExtCreateRegion 함수와 함께 사용됩니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
대상 플랫폼 | Windows |
헤더 | wingdi.h(Windows.h 포함) |
라이브러리 | Gdi32.lib |
DLL | Gdi32.dll |
추가 정보
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기