ID2D1ResourceTexture::Update-Methode (d2d1effectauthor.h)

  • Artikel

Updates die spezifische Ressourcentextur innerhalb des spezifischen Bereichs oder Felds unter Verwendung der angegebenen Daten.

Syntax

HRESULT Update(
  [in, optional] const UINT32 *minimumExtents,
  [in, optional] const UINT32 *maximimumExtents,
  [in]           const UINT32 *strides,
                 UINT32       dimensions,
  [in]           const BYTE   *data,
                 UINT32       dataCount
);

Parameter

[in, optional] minimumExtents

Typ: const UINT32*

Der "linke" Bereich der Updates, falls angegeben; wenn NULL, wird die gesamte Textur aktualisiert.

[in, optional] maximimumExtents

Typ: const UINT32*

Der "richtige" Umfang der Updates, falls angegeben; wenn NULL, wird die gesamte Textur aktualisiert.

[in] strides

Typ: const UINT32*

Der Schritt, um die Eingabedaten entsprechend der Dimension zu durchlaufen.

dimensions

Typ: UINT32

Die Anzahl der Dimensionen in der Ressourcentextur. Dies muss mit der Zahl übereinstimmen, die zum Laden der Textur verwendet wurde.

[in] data

Typ: const BYTE*

Die Daten, die in der Ressourcentextur platziert werden sollen.

dataCount

Typ: UINT32

Die Größe des Datenpuffers, der zum Aktualisieren der Ressourcentextur verwendet werden soll.

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_OUTOFMEMORY Direct2D konnte nicht genügend Arbeitsspeicher zuweisen, um den Anruf abzuschließen.
E_INVALIDARG Ein ungültiger Parameter wurde an die zurückgebende Funktion übergeben.

Hinweise

Die Anzahl der Dimensionen in der Aktualisierung muss mit denen der erstellten Textur übereinstimmen.

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 d2d1effectauthor.h
Bibliothek D2d1.lib

Weitere Informationen

ID2D1EffectContext::CreateResourceTexture

ID2D1ResourceTexture