Partager via


Fonction D3DX11CreateTextureFromFile

Notes

La bibliothèque d’utilitaires D3DX (D3DX 9, D3DX 10 et D3DX 11) est déconseillée pour Windows 8 et n’est pas prise en charge pour les applications du Windows Store.

Notes

Au lieu d’utiliser cette fonction, nous vous recommandons d’utiliser les éléments suivants :

  • Bibliothèque DirectXTK (runtime), CreateXXXTextureFromFile (où XXX est DDS ou WIC)
  • Bibliothèque DirectXTex (outils), LoadFromXXXFile (où XXX est WIC, DDS ou TGA ; WIC ne prend pas en charge DDS et TGA ; D3DX 9 pris en charge TGA comme format de source artistique commun pour les jeux), puis CreateTexture

Créez une ressource de texture à partir d’un fichier.

Syntaxe

HRESULT D3DX11CreateTextureFromFile(
  _In_  ID3D11Device           *pDevice,
  _In_  LPCTSTR                pSrcFile,
  _In_  D3DX11_IMAGE_LOAD_INFO *pLoadInfo,
  _In_  ID3DX11ThreadPump      *pPump,
  _Out_ ID3D11Resource         **ppTexture,
  _Out_ HRESULT                *pHResult
);

Paramètres

pDevice [in]

Type : ID3D11Device*

Pointeur vers l’appareil (voir ID3D11Device) qui utilisera la ressource.

pSrcFile [in]

Type : LPCTSTR

Nom du fichier contenant la ressource. Si les paramètres du compilateur nécessitent Unicode, le type de données LPCTSTR est résolu en LPCWSTR. Sinon, le type de données est résolu en LPCSTR.

pLoadInfo [in]

Type : D3DX11_IMAGE_LOAD_INFO*

Optionnel. Identifie les caractéristiques d’une texture (voir D3DX11_IMAGE_LOAD_INFO) lors de la création du processeur de données ; définissez cette valeur sur NULL pour lire les caractéristiques d’une texture lorsque la texture est chargée.

pPump [in]

Type : ID3DX11ThreadPump*

Pointeur vers une interface de pompe de thread (voir INTERFACE ID3DX11ThreadPump). Si NULL est spécifié, cette fonction se comporte de manière synchrone et ne retourne pas tant qu’elle n’est pas terminée.

ppTexture [out]

Type : ID3D11Resource**

Adresse d’un pointeur vers la ressource de texture (voir ID3D11Resource).

pHResult [out]

Type : HRESULT*

Pointeur vers la valeur de retour. Peut être NULL. Si pPump n’a pas la valeur NULL, pHResult doit être un emplacement de mémoire valide jusqu’à ce que l’exécution asynchrone se termine.

Valeur retournée

Type : HRESULT

La valeur de retour est l’une des valeurs répertoriées dans Codes de retour Direct3D 11.

Spécifications

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

Voir aussi

Fonctions D3DX