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 열거형의 다른 요소 중 하나를 반환합니다.

요구 사항

참고 항목

Bitmap

비트맵::UnlockBits

Bitmapdata

이미지

이미지 픽셀 서식 상수

ImageLockMode

이미지, 비트맵 및 메타파일

이미지, 비트맵 및 메타파일 사용