IImageSink::GetPixelDataBuffer

9/8/2008

Este método é usado por um fonte da imagem para transmitir dados pixel para uma imagem para o coletor imagem.

Use este método se a origem não ainda alocou memória para a imagem.

Uma origem deve apenas chamar este método se o formato negociado retornado a partir IImageSink::BeginSink Foi o identificador formato de imagem ImageFormatMemoryBMP. Para obter mais informações, consulte Imaging GUIDs.

Se a origem tiver dados de pixel na memória no formato de pixel correta, a origem deve chamar IImageSink::PushPixelData Para transmitir um ponteiro para dados de pixel para o coletor.

Syntax

HRESULT GetPixelDataBuffer(
  const RECT*   rect,
  PixelFormatID pixelFormat,
  BOOL          lastPass,
  BitmapData*   bitmapData
);

Parameters

• RECT
  [no] Um ponteiro para um RECT estrutura especificando as dimensões da reserva para dados de pixel.

• pixelFormat
  [no] A PixelFormatID valor especificando o formato de dados para os pixels na reserva.

• lastPass
  [no] Um valor bool que informa o coletor se esse é o último transmitir pela área de imagem especificado.

  Defina esse valor como TRUE se este chamar para IImageSink::GetPixelDataBuffer é o último transmitir; caso contrário, defina como FALSE.

• bitmapData
  [out] Um ponteiro para um BitmapData objeto que representa a reserva dados pixel.

Return Value

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

Esse método pode retornar E_NOTIMPL se ele falhar.

Remarks

O fonte da imagem deve chamar o IImageSink::GetPixelDataBuffer método para solicitação que o coletor alocar memória para o transferência de dados.

O fonte da imagem deve preencher a reserva com o pixel valores e, em seguida, chamar IImageSink::ReleasePixelDataBuffer Para informar o coletor tenham os dados pixel.

Você deve chamar IImageSink::SetPalette Antes de para enviar dados para o coletor.

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

IImageSink
IImageSink::BeginSink
Imaging GUIDs
IImageSink::PushPixelData
PixelFormatID
BitmapData
IImageSink::ReleasePixelDataBuffer

Other Resources