ID2D1Bitmap1::Map-Methode (d2d1_1.h)
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.
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
ID2D1DeviceContext::CreateBitmap