D3DXLoadSurfaceFromFileInMemory fonction)

Charge une surface à partir d’un fichier en mémoire.

Syntaxe

HRESULT D3DXLoadSurfaceFromFileInMemory(
  _In_          LPDIRECT3DSURFACE9 pDestSurface,
  _In_    const PALETTEENTRY       *pDestPalette,
  _In_    const RECT               *pDestRect,
  _In_          LPCVOID            pSrcData,
  _In_          UINT               SrcData,
  _In_    const RECT               *pSrcRect,
  _In_          DWORD              Filter,
  _In_          D3DCOLOR           ColorKey,
  _Inout_       D3DXIMAGE_INFO     *pSrcInfo
);

Paramètres

pDestSurface [ dans]

Type : LPDIRECT3DSURFACE9

Pointeur vers une interface IDirect3DSurface9 . Spécifie la surface de destination, qui reçoit l’image.

pDestPalette [ dans]

Type : const PaletteEntry *

Pointeur vers une structure PaletteEntry , la palette de destination de 256 couleurs ou null.

pDestRect [ dans]

Type : const Rect *

Pointeur vers une structure Rect . Spécifie le rectangle de destination. Affectez la valeur null à ce paramètre pour spécifier la surface entière.

pSrcData [ dans]

Type : LPCVOID

Pointeur vers le fichier en mémoire à partir duquel charger l’aire.

SrcData [ dans]

Type : uint

Taille du fichier en mémoire, en octets.

pSrcRect [ dans]

Type : const Rect *

Pointeur vers une structure Rect . Spécifie le rectangle source. Affectez la valeur null à ce paramètre pour spécifier la totalité de l’image.

Filtre [ dans]

Type : DWORD

Combinaison d’un ou de plusieurs _ filtres D3DX contrôlant la façon dont l’image est filtrée. La spécification _ de la valeur D3DX par défaut pour ce paramètre revient à spécifier la valeur de filtre du _ triangle de filtre D3DX _ | _ _ .

ColorKey [ dans]

Type : D3DCOLOR

Valeur D3DCOLOR à remplacer par le noir transparent, ou 0 pour désactiver le ColorKey. Il s’agit toujours d’une couleur ARVB de 32 bits, indépendante du format d’image source. Alpha est significatif et doit généralement être défini sur FF pour les clés de couleur opaques. Ainsi, pour le noir opaque, la valeur est égale à 0xFF000000.

pSrcInfo [ in, out]

Type : D3DXIMAGE _ info*

Pointeur vers une structure d' _ informations D3DXIMAGE à remplir avec une description des données dans le fichier image source ou null.

Valeur de retour

Type : HRESULT

Si la fonction est réussie, la valeur de retour est D3D _ OK. Si la fonction échoue, la valeur de retour peut être l’une des suivantes : D3DERR _ INVALIDCALL, D3DXERR _ sera déplacé.

Notes

Cette fonction gère la conversion vers et à partir des formats de texture compressés et prend en charge les formats de fichier suivants : .bmp,. DDS,. dib,. HDR, .jpg,. PFM, .png,. ppm et. tga. Consultez D3DXIMAGE _ FILEFORMAT.

L’écriture sur une surface non-niveau zéro n’entraîne pas la mise à jour du rectangle de modification. Si D3DXLoadSurfaceFromFileInMemory est appelé et que la surface n’était pas encore modifiée (ce qui est peu probable dans les scénarios d’utilisation normale), l’application doit appeler explicitement AddDirtyRect sur l’aire.

Spécifications

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

Voir aussi

Fonctions de texture dans D3DX 9