D3DXCreateEffectCompilerFromResource-Funktion

Erstellt einen ID3DXEffectCompiler aus einer ASCII-Effektbeschreibung.

Syntax

HRESULT D3DXCreateEffectCompilerFromResource(
  _In_        HMODULE              hSrcModule,
  _In_        LPCTSTR              pSrcResource,
  _In_  const D3DXMACRO            *pDefines,
  _In_        LPD3DXINCLUDE        pInclude,
  _In_        DWORD                Flags,
  _Out_       LPD3DXEFFECTCOMPILER *ppEffectCompiler,
  _Out_       LPD3DXBUFFER         *ppParseErrors
);

Parameter

hSrcModule [ In]

Typ: HMODULE

Handle für ein Modul, das die Beschreibung des Effekts enthält. Wenn dieser Parameter NULL ist, wird das aktuelle Modul verwendet.

pSrcResource [ In]

Typ: LPCTSTR

Zeiger auf die Ressource. Dieser Parameter unterstützt sowohl Unicode- als auch ANSI-Zeichenfolgen. Siehe Hinweise.

pDefdefine [ In]

Typ: const D3DXMACRO *

Ein optionales, mit NULL beendetes Array von D3DXMACRO-Strukturen, die Präprozessordefinitionen beschreiben. Dieser Wert kann NULL sein.

pInclude [ In]

Typ: LPD3DXINCLUDE

Optionaler Schnittstellenzeiger ID3DXInclude, der für die Behandlung von Include-Direktiven # verwendet werden soll. Wenn dieser Wert NULL ist, wird includes entweder beim Kompilieren aus einer Datei oder beim Kompilieren aus einer Ressource oder einem Arbeitsspeicher # zu einem Fehler führen.

Flags [ In]

Typ: DWORD

Kompilierungsoptionen, die durch verschiedene Flags identifiziert werden (siehe D3DXSHADER-Flags). Der Direct3D 10 HLSL-Compiler ist jetzt die Standardeinstellung. Weitere Informationen finden Sie unter Effect-Compiler Tool .

ppEffectCompiler [ out]

Typ: LPD3DXEFFECTCOMPILER*

Adresse eines Zeigers auf eine ID3DXEffectCompiler-Schnittstelle, die den Effektcompiler enthält.

ppParseErrors [ out]

Typ: LPD3DXBUFFER*

Adresse eines Zeigers auf eine ID3DXBuffer-Schnittstelle, die alle Fehlermeldungen enthält, die während der Kompilierung aufgetreten sind. Dieser Parameter kann auf NULL festgelegt werden, um Fehlermeldungen zu ignorieren.

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ist, ist der Rückgabewert D3D _ OK. Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden sein: D3DERR _ INVALIDCALL, E _ OUTOFMEMORY.

Hinweise

Wenn die Compilereinstellungen Unicode erfordern, wird der Datentyp LPCTSTR in LPCWSTR auflösen. Andernfalls wird der LPCTSTR-Datentyp in LPCSTR auflösen.

Die Compilereinstellung bestimmt auch die Funktionsversion. Wenn Unicode definiert ist, wird der Funktionsaufruf in D3DXCreateEffectCompilerFromResourceW auflösen. Andernfalls wird der Funktionsaufruf in D3DXCreateEffectCompilerFromResourceA auflösen, da ANSI-Zeichenfolgen verwendet werden.

Anforderungen

Anforderung Wert
Header
D3DX9Effect.h
Bibliothek
D3dx9.lib

Siehe auch

Effect-Funktionen

D3DXCreateEffectCompiler

D3DXCreateEffectCompilerFromFile