ID2D1EffectContext::CreateVertexBuffer-Methode (d2d1effectauthor.h)
Erstellt einen Vertexpuffer oder sucht einen Standardvertexpuffer und initialisiert ihn optional mit Scheitelpunkten. Der zurückgegebene Puffer kann in den Renderinformationen angegeben werden, um sowohl einen Vertex-Shader anzugeben als auch benutzerdefinierte Scheitelpunkte an den Standardvertex-Shader zu übergeben, der von Direct2D verwendet wird.
Syntax
HRESULT CreateVertexBuffer(
[in] const D2D1_VERTEX_BUFFER_PROPERTIES *vertexBufferProperties,
[in, optional] const GUID *resourceId,
[in, optional] const D2D1_CUSTOM_VERTEX_BUFFER_PROPERTIES *customVertexBufferProperties,
[out] ID2D1VertexBuffer **buffer
);
Parameter
[in] vertexBufferProperties
Typ: const D2D1_VERTEX_BUFFER_PROPERTIES*
Die Eigenschaften, die zum Beschreiben des Vertexpuffers und des Vertex-Shaders verwendet werden.
[in, optional] resourceId
Typ: const GUID*
Die eindeutige ID, die den Vertexpuffer identifiziert.
[in, optional] customVertexBufferProperties
Typ: const D2D1_CUSTOM_VERTEX_BUFFER_PROPERTIES*
Die Eigenschaften, die zum Definieren eines benutzerdefinierten Vertexpuffers verwendet werden. Wenn Sie einen integrierten Vertex-Shader verwenden, müssen Sie diese Eigenschaft nicht angeben.
[out] buffer
Typ: ID2D1VertexBuffer**
Der zurückgegebene Vertexpuffer.
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 Aufruf abzuschließen. |
| E_INVALIDARG | Ein ungültiger Parameter wurde an die zurückgebende Funktion übergeben. |
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 |