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 |
|
| Bibliothèque |
|