ID3D10Device::CreateTexture2D-Methode (d3d10.h)

Erstellen Sie ein Array von 2D-Texturen (siehe Textur2D).

Syntax

HRESULT CreateTexture2D(
  [in]  const D3D10_TEXTURE2D_DESC   *pDesc,
  [in]  const D3D10_SUBRESOURCE_DATA *pInitialData,
  [out] ID3D10Texture2D              **ppTexture2D
);

Parameter

[in] pDesc

Typ: const D3D10_TEXTURE2D_DESC*

Zeiger auf eine 2D-Texturbeschreibung (siehe D3D10_TEXTURE2D_DESC). Um eine typlose Ressource zu erstellen, die zur Laufzeit in verschiedene kompatible Formate interpretiert werden kann, geben Sie in der Texturbeschreibung ein typloses Format an. Um Mipmap-Ebenen automatisch zu generieren, legen Sie die Anzahl der Mipmap-Ebenen auf 0 fest.

[in] pInitialData

Typ: const D3D10_SUBRESOURCE_DATA*

Zeiger auf ein Array von Unterressourcenbeschreibungen (siehe D3D10_SUBRESOURCE_DATA); eine für jede Unterressource (sortiert nach Texturarrayindex, dann MIP-Ebene). Anwendungen geben beim Erstellen von IMMUTABLE-Ressourcen möglicherweise nicht NULL für pInitialData an (siehe D3D10_USAGE). Wenn die Ressource multisampled ist, muss pInitialData NULL sein, da multisampled-Ressourcen nicht mit Daten initialisiert werden können, wenn sie erstellt werden.

[out] ppTexture2D

Typ: ID3D10Texture2D**

Adresse eines Zeigers auf die erstellte Textur (siehe ID3D10Texture2D-Schnittstelle). Legen Sie diesen Parameter auf NULL fest, um die anderen Eingabeparameter zu überprüfen (die Methode gibt S_FALSE zurück, wenn die anderen Eingabeparameter die Überprüfung bestehen).

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabecode S_OK. Fehlercodes finden Sie unter Direct3D 10-Rückgabecodes .

Hinweise

CreateTexture2D erstellt eine 2D-Texturressource, die ein Array von 1D-Texturen enthält. Die Anzahl der Texturen wird in der Texturbeschreibung angegeben. Alle Texturen in einer Ressource müssen das gleiche Format, die gleiche Größe und die gleiche Anzahl von Mipmap-Ebenen aufweisen.

Alle Ressourcen bestehen aus einer oder mehreren Unterressourcen. Zum Laden von Daten in die Textur können Anwendungen die Daten zunächst als Teil D3D10_SUBRESOURCE_DATA Struktur bereitstellen, auf die von pInitialData verwiesen wird, oder sie können eine der vom SDK bereitgestellten Texturfunktionen verwenden.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile d3d10.h
Bibliothek D3D10.lib

Weitere Informationen

ID3D10Geräteschnittstelle