ID3DInclude ::Open, méthode (d3dcommon.h)

Article
02/26/2024

Méthode implémentée par l’utilisateur pour ouvrir et lire le contenu d’un fichier de nuanceur #include.

Syntaxe

HRESULT Open(
  D3D_INCLUDE_TYPE IncludeType,
  LPCSTR           pFileName,
  LPCVOID          pParentData,
  LPCVOID          *ppData,
  UINT             *pBytes
);

Paramètres

IncludeType

Type : D3D_INCLUDE_TYPE

Valeur de type D3D_INCLUDE_TYPE qui indique l’emplacement du fichier #include.

pFileName

Type : LPCSTR

Nom du fichier #include.

pParentData

Type : LPCVOID

Pointeur vers le conteneur qui inclut le fichier #include. Le compilateur peut passer null dans pParentData. Pour plus d’informations, consultez la section « Recherche de fichiers Include » dans Compiler un effet (Direct3D 11).

ppData

Type : LPCVOID*

Pointeur vers la mémoire tampon qui contient les directives include. Ce pointeur reste valide jusqu’à ce que vous appeliezID3DInclude ::Close.

pBytes

Type : UINT*

Pointeur vers le nombre d’octets retourné par Open dans ppData.

Valeur retournée

Type : HRESULT

La méthode implémentée par l’utilisateur doit retourner S_OK. Si Open échoue lorsqu’il lit le fichier #include, l’interface de programmation d’application (API) qui a provoqué l’appel d’Open échoue. Cet échec peut se produire dans l’une des situations suivantes :

Le nuanceur HLSL (high-level shader language) échoue à l’une des fonctions D3D10CompileShader*** .
L’effet échoue à l’une des fonctions D3D10CreateEffect** *.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	d3dcommon.h
Bibliothèque	D3DCompiler.lib
DLL	D3DCompiler_47.dll

Voir aussi

ID3DInclude

ID3DInclude ::Close

Partager via