ID2D1Bitmap1::Map-Methode (d2d1_1.h)

  • Artikel

Ordnet die angegebene Bitmap dem Arbeitsspeicher zu.

Syntax

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

Parameter

options

Typ: D2D1_MAP_OPTIONS

Die Optionen, die zum Zuordnen der Bitmap in den Arbeitsspeicher verwendet werden.

[out] mappedRect

Typ: D2D1_MAPPED_RECT*

Wenn diese Methode zurückgibt, enthält einen Verweis auf das Rechteck, das dem Arbeitsspeicher zugeordnet ist.

Rückgabewert

Typ: HRESULT

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

HRESULT BESCHREIBUNG
S_OK Kein Fehler ist aufgetreten.
E_INVALIDARG Mindestens ein Argument ist ungültig.
D3DERR_DEVICELOST Das Gerät ist verloren gegangen, kann aber zu diesem Zeitpunkt nicht zurückgesetzt werden.

Hinweise

Hinweis Sie können Bitmaps nicht für bestimmte Zwecke verwenden, während sie zugeordnet sind. Insbesondere funktioniert die ID2D1Bitmap::CopyFromBitmap-Methode nicht, wenn entweder die Quell- oder Ziel-Bitmap zugeordnet ist.
 
Die Bitmap muss mit dem angegebenen D2D1_BITMAP_OPTIONS_CPU_READ Flag erstellt worden sein.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile d2d1_1.h
DLL D2d1.dll

Weitere Informationen

ID2D1Bitmap1

ID2D1DeviceContext::CreateBitmap

ID2D1DeviceContext::CreateBitmapFromDxgiSurface

ID2D1RenderTarget::CreateSharedBitmap