Partager via


ID3DXInclude::Open, méthode

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

Syntaxe

HRESULT Open(
  [in]  D3DXINCLUDE_TYPE IncludeType,
  [in]  LPCSTR           pFileName,
  [in]  LPCVOID          pParentData,
  [out] LPCVOID          *ppData,
  [out] UINT             *pBytes
);

Paramètres

IncludeType [in]

Type : D3DXINCLUDE_TYPE

Emplacement du fichier #include. Voir D3DXINCLUDE_TYPE.

pFileName [in]

Type : LPCSTR

Nom du fichier #include.

pParentData [in]

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 [out]

Type : LPCVOID*

Pointeur vers la mémoire tampon retournée qui contient les directives include. Ce pointeur reste valide jusqu’à ce que ID3DXInclude::Close soit appelé.

pBytes [out]

Type : UINT*

Nombre d’octets retournés dans ppData.

Valeur retournée

Type : HRESULT

La méthode implémentée par l’utilisateur doit retourner S_OK. Si le rappel échoue lors de la lecture du fichier #include, l’API qui a provoqué l’appel du rappel échoue. Il s’agit de l’une des opérations suivantes :

  • Le nuanceur HLSL échoue à l’une des fonctions D3DXCompileShader***.
  • Le nuanceur d’assembly échoue à l’une des fonctions D3DXAssembleShader***.
  • L’effet échoue à l’une des fonctions D3DXCreateEffect*** ou D3DXCreateEffectCompiler***.

Spécifications

Condition requise Valeur
En-tête
D3DX9Shader.h
Bibliothèque
D3dx9.lib

Voir aussi

ID3DXInclude

ID3DXInclude::Close