D3DXCreateEffectCompilerFromFile-Funktion
Erstellt einen Effektcompiler aus einer ASCII-Effektbeschreibung.
Syntax
HRESULT D3DXCreateEffectCompilerFromFile(
_In_ LPCTSTR pSrcFile,
_In_ const D3DXMACRO *pDefines,
_In_ LPD3DXINCLUDE pInclude,
_In_ DWORD Flags,
_Out_ LPD3DXEFFECTCOMPILER *ppEffectCompiler,
_Out_ LPD3DXBUFFER *ppParseErrors
);
Parameter
-
pSrcFile [in]
-
Typ: LPCTSTR
Zeiger auf den Dateinamen. Dieser Parameter unterstützt sowohl Unicode- als auch ANSI-Zeichenfolgen. Siehe Hinweise.
-
pDefines [in]
-
Typ: const D3DXMACRO*
Ein optionales 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 Verarbeitung #include-Anweisungen verwendet werden soll. Wenn dieser Wert NULL ist, wird #includes entweder beim Kompilieren aus einer Datei berücksichtigt oder verursacht einen Fehler, wenn er aus einer Ressource oder einem Arbeitsspeicher kompiliert wird.
-
Flaggen [in]
-
Typ: DWORD
Kompilieren von Optionen, die durch verschiedene Flags identifiziert werden (siehe D3DXSHADER Flags). Der Direct3D 10 HLSL-Compiler ist jetzt der Standard. 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, wird der Rückgabewert D3D_OK. Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden sein: D3DERR_INVALIDCALL, E_OUTOFMEMORY.
Bemerkungen
Wenn die Compilereinstellungen Unicode erfordern, wird der Datentyp LPCTSTR in LPCWSTR aufgelöst. Andernfalls wird der LPCTSTR-Datentyp in LPCSTR aufgelöst.
Die Compilereinstellung bestimmt auch die Funktionsversion. Wenn Unicode definiert ist, wird der Funktionsaufruf in D3DXCreateEffectCompilerFromFileW aufgelöst. Andernfalls wird der Funktionsaufruf in D3DXCreateEffectCompilerFromFileA aufgelöst, da ANSI-Zeichenfolgen verwendet werden.
Anforderungen
Anforderung | Wert |
---|---|
Header |
|
Bibliothek |
|
Siehe auch