IBitmapImage::LockBits

9/8/2008

Esse bloqueio aplicativos permite método uma área de um objeto imagem de bitmap e acessar dados bitmap na formato do pixel especificado.

Syntax

HRESULT LockBits(
  const RECT*   rect,
  UINT          flags,
  PixelFormatID pixelFormat,
  BitmapData*   lockedBitmapData
);

Parameters

• RECT
  [no] Um ponteiro para uma estrutura RECT que define a região do bitmap para bloqueio.

• Sinalizadores
  [no] Um valor UINT que descreve o tipo de bloqueio.

  Este valor deve ser um ImageLockMode valor de enumeração ou uma combinação de ImageLockMode Os valores.

  Este parâmetro deve conter os valores ImageLockModeRead ou ImageLockModeWrite.

• pixelFormat
  [no] A PixelFormatID valor que especifica o formato pixel da área bitmap bloqueada.

  Este valor deve ser definido como um do Valores PixelFormat.

  Para usar o atual formato pixel do imagem de bitmap, defina este valor como PixelFormatDontCare.

  Objetos imagem de bitmap não é necessário para suporte pixel todos os formatos, mas eles devem suporte a pixel canônico formatos.

• lockedBitmapData
  [in, Out] Um ponteiro para uma instância de um BitmapData classe que contém dados sobre os pixels bloqueadas.

  Se o bit ImageLockModeUserInputBuf das Sinalizadores parâmetro for definido, o lockedBitmapData-> Scan0 e lockedBitmapData-> STRIDE Membros devem conter valores válido na entrada.

  Seu aplicativo deve chamar o IBitmapImage::UnlockBits método quando ele é feito usando dados de pixel. Bloqueios simultâneos não são permitidos no mesmo objeto imagem de bitmap.

Return Value

Se bem-sucedido, esse método Retorna S_OK.

Se ele falhar, esse método deve retornar uma dos seguinte valores de erro:

• IMGERR_BADLOCK
• IMGERR_OBJECTBUSY
• E_FAIL
• E_INVALIDARG

Para obter mais informações, consulte Códigos de erro para o Imaging API.

Requirements

Header	imaging.h
Library	Imaging.lib
Windows Embedded CE	Windows CE 5.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

IBitmapImage
ImageLockMode
PixelFormatID
PixelFormat Values
BitmapData
IBitmapImage::UnlockBits