D3DX11CreateShaderResourceViewFromFile-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, wird empfohlen, Folgendes zu verwenden:

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

Erstellen Sie eine Shader-Ressourcenansicht aus einer Datei.

Syntax

HRESULT D3DX11CreateShaderResourceViewFromFile(
  _In_  ID3D11Device             *pDevice,
  _In_  LPCTSTR                  pSrcFile,
  _In_  D3DX11_IMAGE_LOAD_INFO   *pLoadInfo,
  _In_  ID3DX11ThreadPump        *pPump,
  _Out_ ID3D11ShaderResourceView **ppShaderResourceView,
  _Out_ HRESULT                  *pHResult
);

Parameter

pDevice [ In]

Typ: ID3D11Device*

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

pSrcFile [ In]

Typ: LPCTSTR

Name der Datei, die die Shader-Ressourcenansicht 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 Datenprozessor erstellt wird. Legen Sie diese Eigenschaft auf NULL fest, um die Merkmale einer Textur zu lesen, wenn die Textur geladen wird.

pPump [ In]

Typ: ID3DX11ThreadPump*

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

ppShaderResourceView [ out]

Typ: ID3D11ShaderResourceView**

Adresse eines Zeigers auf die Shader-Ressourcenansicht (siehe ID3D11ShaderResourceView).

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ührtenWerte.

Bemerkungen

Eine Liste der unterstützten Bildformate finden Sie unter D3DX11 _ IMAGE _ FILE _ FORMAT.

Requirements (Anforderungen)

Anforderung Wert
Header
D3DX11tex.h
Bibliothek
D3DX11.lib

Weitere Informationen

D3DX-Funktionen