Metodo ID2D1Bitmap1::Map (d2d1_1.h)

Esegue il mapping della bitmap specificata in memoria.

Sintassi

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

Parametri

options

Tipo: D2D1_MAP_OPTIONS

Opzioni usate per il mapping della bitmap in memoria.

[out] mappedRect

Tipo: D2D1_MAPPED_RECT*

Quando termina, questo metodo contiene un riferimento al rettangolo mappato in memoria.

Valore restituito

Tipo: HRESULT

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

HRESULT Descrizione
S_OK Non si sono verificati errori.
E_INVALIDARG Uno o più argomenti non sono validi
D3DERR_DEVICELOST Il dispositivo è stato perso ma non può essere reimpostato in questo momento.

Commenti

Nota Non è possibile usare le bitmap per alcuni scopi durante il mapping. In particolare, il metodo ID2D1Bitmap::CopyFromBitmap non funziona se viene eseguito il mapping della bitmap di origine o di destinazione.
 
La bitmap deve essere stata creata con il flag D2D1_BITMAP_OPTIONS_CPU_READ specificato.

Requisiti

   
Client minimo supportato Windows 8 e Platform Update per Windows 7 [app desktop | App UWP]
Server minimo supportato Windows Server 2012 e Aggiornamento della piattaforma per Windows Server 2008 R2 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione d2d1_1.h
DLL D2d1.dll

Vedi anche

ID2D1Bitmap1

ID2D1DeviceContext::CreateBitmap

ID2D1DeviceContext::CreateBitmapFromDxgiSurface

ID2D1RenderTarget::CreateSharedBitmap