Metodo ID2D1Bitmap1::Map (d2d1_1.h)

Articolo
08/22/2023

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

Condividi tramite