Bitmap::LockBits 메서드(gdiplusheaders.h)
Bitmap::LockBits 메서드는 이 비트맵의 사각형 부분을 잠그고 지정된 형식으로 픽셀 데이터를 읽거나 쓰는 데 사용할 수 있는 임시 버퍼를 제공합니다. 버퍼에 쓰는 모든 픽셀 데이터는 Bitmap::UnlockBits를 호출할 때 Bitmap 개체에 복사됩니다.
구문
Status LockBits(
[in] const Rect *rect,
[in] UINT flags,
[in] PixelFormat format,
[in, out] BitmapData *lockedBitmapData
);
매개 변수
[in] rect
형식: const Rect*
잠글 비트맵의 부분을 지정하는 사각형에 대한 포인터입니다.
[in] flags
형식: UINT
비트맵의 잠긴 부분을 읽기 또는 쓰기에 사용할 수 있는지 여부와 호출자가 이미 버퍼를 할당했는지 여부를 지정하는 플래그 집합입니다. 개별 플래그는 ImageLockMode 열거형에 정의됩니다.
[in] format
형식: PixelFormat
임시 버퍼의 픽셀 데이터 형식을 지정하는 정수입니다. 임시 버퍼의 픽셀 형식이 이 Bitmap 개체의 픽셀 형식과 같을 필요는 없습니다. 다양한 픽셀 형식을 나타내는 PixelFormat 데이터 형식 및 상수는 Gdipluspixelformats.h에 정의되어 있습니다. 픽셀 서식 상수에 대한 자세한 내용은 이미지 픽셀 서식 상수를 참조하세요. GDI+ 버전 1.0은 채널당 16비트 이미지 처리를 지원하지 않으므로 이 매개 변수를 PixelFormat48bppRGB, PixelFormat64bppARGB 또는 PixelFormat64bppPARGB와 같게 설정해서는 안 됩니다.
[in, out] lockedBitmapData
형식: BitmapData*
BitmapData 개체에 대한 포인터입니다. flags 매개 변수의 ImageLockModeUserInputBuf 플래그가 지워지면 lockedBitmapData는 출력 매개 변수로만 사용됩니다. 이 경우 BitmapData 개체의 Scan0 데이터 멤버는 요청된 픽셀의 값으로 채워진 임시 버퍼에 대한 포인터를 받습니다. BitmapData 개체의 다른 데이터 멤버는 임시 버퍼에서 픽셀 데이터의 특성(너비, 높이, 형식 및 보폭)을 받습니다. 픽셀 데이터가 상향식으로 저장되면 Stride 데이터 멤버는 음수입니다. 픽셀 데이터가 하향식으로 저장되면 Stride 데이터 멤버는 양수입니다. flags 매개 변수의 ImageLockModeUserInputBuf 플래그가 설정된 경우 lockedBitmapData는 입력 매개 변수(및 출력 매개 변수일 수 있음)로 사용됩니다. 이 경우 호출자는 읽거나 쓸 픽셀 데이터에 대한 버퍼를 할당해야 합니다. 또한 호출자는 BitmapData 개체를 만들고, 해당 BitmapData 개체의 Scan0 데이터 멤버를 버퍼의 주소로 설정하고, BitmapData 개체의 다른 데이터 멤버를 설정하여 버퍼의 특성(너비, 높이, 형식 및 보폭)을 지정해야 합니다.
반환 값
형식: 상태
메서드가 성공하면 Status 열거형의 요소인 Ok를 반환합니다.
메서드가 실패하면 Status 열거형의 다른 요소 중 하나를 반환합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows XP, Windows 2000 Professional [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | gdiplusheaders.h(Gdiplus.h 포함) |
| 라이브러리 | Gdiplus.lib |
| DLL | Gdiplus.dll |