D3DX10CreateSprite-Funktion

Artikel
06/12/2023

Erstellen Sie einen Sprite zum Zeichnen einer 2D-Textur.

Hinweis

Anstelle dieser Funktion empfiehlt es sich, Direct2D und die DirectXTK-BibliothekSpriteBatch-Klasse zu verwenden.

Syntax

HRESULT D3DX10CreateSprite(
  _In_  ID3D10Device   *pDevice,
  _In_  UINT           cDeviceBufferSize,
  _Out_ LPD3DX10SPRITE *ppSprite
);

Parameter

pDevice [in]

Typ: ID3D10Geräte*

Ein Zeiger auf das Gerät (siehe ID3D10Device Interface), mit dem der Sprite gezeichnet wird.

cDeviceBufferSize [in]

Typ: UINT

Die Größe des Vertexpuffers in Der Anzahl der Sprites, die an das Gerät gesendet wird, wenn ID3DX10Sprite::Flush oder ID3DX10Sprite::D rawSpritesImmediate aufgerufen wird. Dies sollte eine kleine Zahl sein, wenn Sie wissen, dass Sie eine kleine Anzahl von Sprites gleichzeitig rendern (um Arbeitsspeicher zu sparen) und eine große Zahl, wenn Sie wissen, dass Sie eine große Anzahl von Sprites gleichzeitig rendern. Der Maximalwert ist 4096. Wenn 0 angegeben ist, wird die Vertexpuffergröße automatisch auf 4096 festgelegt.

ppSprite [out]

Typ: LPD3DX10SPRITE*

Die Adresse eines Zeigers auf eine Sprite-Schnittstelle (siehe ID3DX10Sprite-Schnittstelle).

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ist, wird der Rückgabewert S_OK. Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden sein: D3DERR_INVALIDCALL, E_OUTOFMEMORY.

Anforderungen

Anforderung	Wert
Header	D3DX10.h
Bibliothek	D3DX10.lib

Siehe auch

Universell-Funktionen

Freigeben über