D3DXCreateEffectCompiler-Funktion

Erstellt einen Effektcompiler aus einer ASCII-Effektbeschreibung.

Syntax

HRESULT D3DXCreateEffectCompiler(
  _In_        LPCSTR               pSrcData,
  _In_        UINT                 SrcDataLen,
  _In_  const D3DXMACRO            *pDefines,
  _In_        LPD3DXINCLUDE        pInclude,
  _In_        DWORD                Flags,
  _Out_       LPD3DXEFFECTCOMPILER *ppEffectCompiler,
  _Out_       LPD3DXBUFFER         *ppParseErrors
);

Parameter

pSrcData [in]

Typ: LPCSTR

Zeiger auf einen Puffer, der eine Effektbeschreibung enthält.

SrcDataLen [in]

Typ: UINT

Länge der Effektdaten in Bytes.

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

Anforderungen

Siehe auch

Effektfunktionen

D3DXCreateEffectCompilerFromFile

D3DXCreateEffectCompilerFromResource