ID3D11Device::CreateTexture1D-Methode (d3d11.h)

  • Artikel

Erstellt ein Array von 1D-Texturen.

Syntax

HRESULT CreateTexture1D(
  [in]            const D3D11_TEXTURE1D_DESC   *pDesc,
  [in, optional]  const D3D11_SUBRESOURCE_DATA *pInitialData,
  [out, optional] ID3D11Texture1D              **ppTexture1D
);

Parameter

[in] pDesc

Typ: const D3D11_TEXTURE1D_DESC*

Ein Zeiger auf eine D3D11_TEXTURE1D_DESC-Struktur , die eine 1D-Texturressource beschreibt. Um eine typlose Ressource zu erstellen, die zur Laufzeit in verschiedenen, kompatiblen Formaten 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, optional] pInitialData

Typ: const D3D11_SUBRESOURCE_DATA*

Ein Zeiger auf ein Array von D3D11_SUBRESOURCE_DATA Strukturen, die Unterressourcen für die 1D-Texturressource beschreiben. Anwendungen können null fürpInitialData beim Erstellen von IMMUTABLE Ressourcen nicht angeben (siehe D3D11_USAGE). Wenn die Ressource multisampled ist, muss pInitialDataNULL sein, da multisampled-Ressourcen nicht mit Daten initialisiert werden können, wenn sie erstellt werden.

Wenn Sie nichts an pInitialData übergeben, ist der anfängliche Inhalt des Arbeitsspeichers für die Ressource undefiniert. In diesem Fall müssen Sie den Ressourceninhalt auf andere Weise schreiben, bevor die Ressource gelesen wird.

Sie können die Größe dieses Arrays anhand von Werten in den MipLevels - und ArraySize-Membern der D3D11_TEXTURE1D_DESC Struktur bestimmen, auf die pDesc-Punkte verweist, indem Sie die folgende Berechnung verwenden:

MipLevels * ArraySize

Weitere Informationen zu dieser Arraygröße finden Sie unter Hinweise.

[out, optional] ppTexture1D

Typ: ID3D11Texture1D**

Ein Zeiger auf einen Puffer, der einen Zeiger auf eine ID3D11Texture1D-Schnittstelle für die erstellte Textur empfängt. 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 11-Rückgabecodes .

Hinweise

CreateTexture1D erstellt eine 1D-Texturressource, die eine Reihe von 1D-Unterressourcen enthalten kann. 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 Array von D3D11_SUBRESOURCE_DATA Strukturen bereitstellen, auf die von pInitialData verwiesen wird, oder sie können eine der D3DX-Texturfunktionen wie D3DX11CreateTextureFromFile verwenden.

Für eine Textur mit 32 Breite mit einer vollständigen Mipmap-Kette verfügt das pInitialData-Array über die folgenden 6 Elemente:

  • pInitialData[0] = 32x1
  • pInitialData[1] = 16x1
  • pInitialData[2] = 8x1
  • pInitialData[3] = 4x1
  • pInitialData[4] = 2x1
  • pInitialData[5] = 1x1

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile d3d11.h
Bibliothek D3D11.lib

Weitere Informationen

ID3D11Device