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

Weitere Informationen

ID3D10Geräteschnittstelle