D3DX10CreateEffectFromFile-Funktion

Erstellen Sie einen Effekt aus einer Datei.

Syntax

HRESULT D3DX10CreateEffectFromFile(
  _In_        LPCTSTR            pFileName,
  _In_  const D3D_SHADER_MACRO *pDefines,
  _In_        ID3D10Include      *pInclude,
  _In_        LPCSTR             pProfile,
  _In_        UINT               HLSLFlags,
  _In_        UINT               FXFlags,
  _In_        ID3D10Device       *pDevice,
  _In_        ID3D10EffectPool   *pEffectPool,
  _In_        ID3DX10ThreadPump  *pPump,
  _Out_       ID3D10Effect       **ppEffect,
  _Out_       ID3D10Blob         **ppErrors,
  _Out_       HRESULT            *pHResult
);

Parameter

pFileName [ In]

Typ: LPCTSTR

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

pDefdefine [ In]

Typ: const D3D _ SHADER _ MACRO *

Ein auf NULL terminiertes Array von Shadermakros (siehe D3D-SHADER-MAKRO). _ _Legen Sie diesen Wert auf NULL fest, um keine Makros anzugeben.

pInclude [ In]

Typ: ID3D10Include*

Ein Zeiger auf eine Includeschnittstelle (siehe ID3D10Include Interface). Dieser Parameter kann NULL sein.

pProfile [ In]

Typ: LPCSTR

Eine Zeichenfolge, die das Shaderprofil oderdas Shadermodell angibt.

HLSLFlags [ In]

Typ: UINT

HLSL-Kompilierungsoptionen (siehe D3D10-SHADER-Konstanten _ ).

FXFlags [ In]

Typ: UINT

Effect-Kompilierungsoptionen (siehe Kompilierungs- und Effektflags).

pDevice [ In]

Typ: ID3D10Device*

Ein Zeiger auf das Gerät (siehe ID3D10Device Interface),das die Ressourcen verwendet.

pEffectPool [ In]

Typ: ID3D10EffectPool*

Zeiger auf einen Effektpool (siehe ID3D10EffectPool-Schnittstelle) zum Freigeben von Variablen zwischen Effekten.

pPump [ In]

Typ: ID3DX10ThreadPump*

Ein Zeiger auf eine Threadpumpschnittstelle (siehe ID3DX10ThreadPump-Schnittstelle). Verwenden Sie NULL, um anzugeben, dass diese Funktion erst zurückgegeben werden soll, wenn sie abgeschlossen ist.

ppEffect [ out]

Typ: ID3D10Effect**

Adresse eines Zeigers auf den Effekt (siehe ID3D10Effect-Schnittstelle), der erstellt wird.

ppErrors [ out]

Typ: ID3D10Blob**

Die Adresse eines Zeigers auf den Arbeitsspeicher (siehe ID3D10Blob-Schnittstelle), der Kompilierungsfehler für Auswirkungen enthält, sofern diese aufgetreten sind.

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 Unter Direct3D 10-Rückgabecodes aufgeführten Werte.

Anforderungen

Anforderung Wert
Header
D3DX10Async.h

Weitere Informationen

Universell Functions