Compartilhar via


Método ID2D1Bitmap1::Map (d2d1_1.h)

Mapeia o bitmap especificado para a memória.

Sintaxe

HRESULT Map(
        D2D1_MAP_OPTIONS options,
  [out] D2D1_MAPPED_RECT *mappedRect
);

Parâmetros

options

Tipo: D2D1_MAP_OPTIONS

As opções usadas no mapeamento do bitmap para a memória.

[out] mappedRect

Tipo: D2D1_MAPPED_RECT*

Quando esse método retorna, contém uma referência ao retângulo que é mapeado para a memória.

Valor retornado

Tipo: HRESULT

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

HRESULT Descrição
S_OK Não ocorreu nenhum erro.
E_INVALIDARG Um ou mais argumentos não são válidos
D3DERR_DEVICELOST O dispositivo foi perdido, mas não pode ser redefinido no momento.

Comentários

Nota Você não pode usar bitmaps para algumas finalidades enquanto mapeado. Particularmente, o método ID2D1Bitmap::CopyFromBitmap não funcionará se o bitmap de origem ou de destino estiver mapeado.
 
O bitmap deve ter sido criado com o sinalizador D2D1_BITMAP_OPTIONS_CPU_READ especificado.

Requisitos

   
Cliente mínimo com suporte Windows 8 e Platform Update para Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 e Platform Update para Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho d2d1_1.h
DLL D2d1.dll

Confira também

ID2D1Bitmap1

ID2D1DeviceContext::CreateBitmap

ID2D1DeviceContext::CreateBitmapFromDxgiSurface

ID2D1RenderTarget::CreateSharedBitmap