D3DX11CreateTextureFromFile-Funktion

Hinweis

Die Hilfsprogrammbibliothek D3DX (D3DX 9, D3DX 10 und D3DX 11) ist für Windows 8 veraltet und wird für Windows Store-Apps nicht unterstützt.

Hinweis

Anstatt diese Funktion zu verwenden, empfiehlt es sich, folgendes zu verwenden:

• DirectXTK-Bibliothek (Runtime), CreateXXXTextureFromFile (wobei XXX DDS oder WIC ist)
• DirectXTex-Bibliothek (Tools), LoadFromXXXFile (wobei XXX FÜR WIC, DDS oder TGA steht; WIC unterstützt DDS und TGA nicht. D3DX 9 unterstützte TGA als gängiges Kunstquellenformat für Spiele) dann CreateTexture

Erstellen Sie eine Texturressource aus einer Datei.

Syntax

HRESULT D3DX11CreateTextureFromFile(
  _In_  ID3D11Device           *pDevice,
  _In_  LPCTSTR                pSrcFile,
  _In_  D3DX11_IMAGE_LOAD_INFO *pLoadInfo,
  _In_  ID3DX11ThreadPump      *pPump,
  _Out_ ID3D11Resource         **ppTexture,
  _Out_ HRESULT                *pHResult
);

Parameter

pDevice [in]

Typ: ID3D11Geräte*

Ein Zeiger auf das Gerät (siehe ID3D11Device), das die Ressource verwendet.

pSrcFile [in]

Typ: LPCTSTR

Der Name der Datei, die die Ressource enthält. Wenn die Compilereinstellungen Unicode erfordern, wird der Datentyp LPCTSTR in LPCWSTR aufgelöst. Andernfalls wird der Datentyp in LPCSTR aufgelöst.

pLoadInfo [in]

Typ: D3DX11_IMAGE_LOAD_INFO*

Optional. Identifiziert die Merkmale einer Textur (siehe D3DX11_IMAGE_LOAD_INFO), wenn der Datenverarbeiter erstellt wird; Legen Sie dies auf NULL fest, um die Eigenschaften einer Textur zu lesen, wenn die Textur geladen wird.

pPump [in]

Typ: ID3DX11ThreadPump*

Ein Zeiger auf eine Threadpumpenschnittstelle (siehe ID3DX11ThreadPump-Schnittstelle). Wenn NULL angegeben ist, verhält sich diese Funktion synchron und wird erst zurückgegeben, wenn sie abgeschlossen ist.

ppTexture [out]

Typ: ID3D11Resource**

Die Adresse eines Zeigers auf die Texturressource (siehe ID3D11Resource).

pHResult [out]

Typ: HRESULT*

Ein Zeiger auf den Rückgabewert. Kann NULL sein. Wenn pPump nicht NULL ist, muss pHResult ein gültiger Speicherort sein, bis die asynchrone Ausführung abgeschlossen ist.

Rückgabewert

Typ: HRESULT

Der Rückgabewert ist einer der In Direct3D 11-Rückgabecodes aufgeführten Werte.

Anforderungen

Anforderung	Wert
Header	D3DX11.h
Bibliothek	D3DX11.lib

Siehe auch

D3DX-Funktionen