D3DXLoadVolumeFromMemory fonction)

Charge un volume à partir de la mémoire.

Syntaxe

HRESULT D3DXLoadVolumeFromMemory(
  _In_       LPDIRECT3DVOLUME9 pDestVolume,
  _In_ const PALETTEENTRY      *pDestPalette,
  _In_ const D3DBOX            *pDestBox,
  _In_       LPCVOID           pSrcMemory,
  _In_       D3DFORMAT         SrcFormat,
  _In_       UINT              SrcRowPitch,
  _In_       UINT              SrcSlicePitch,
  _In_ const PALETTEENTRY      *pSrcPalette,
  _In_ const D3DBOX            *pSrcBox,
  _In_       DWORD             Filter,
  _In_       D3DCOLOR          ColorKey
);

Paramètres

pDestVolume [ dans]

Type : LPDIRECT3DVOLUME9

Pointeur vers une interface IDirect3DVolume9 . Spécifie le volume 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.

pDestBox [ dans]

Type : const D3DBOX *

Pointeur vers une structure D3DBOX . Spécifie la zone de destination. Affectez la valeur null à ce paramètre pour spécifier la totalité du volume.

pSrcMemory [ dans]

Type : LPCVOID

Pointeur vers l’angle supérieur gauche du volume source en mémoire.

SrcFormat [ dans]

Type : D3DFORMAT

Membre du type énuméré D3DFORMAT , format de pixel du volume source.

SrcRowPitch [ dans]

Type : uint

Hauteur de l’image source, en octets. Pour les formats DXT (formats de texture compressés), ce nombre doit représenter la taille d’une ligne de cellules, en octets.

SrcSlicePitch [ dans]

Type : uint

Hauteur de l’image source, en octets. Pour les formats DXT (formats de texture compressés), ce nombre doit représenter la taille d’une tranche de cellules, en octets.

pSrcPalette [ dans]

Type : const PaletteEntry *

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

pSrcBox [ dans]

Type : const D3DBOX *

Pointeur vers une structure D3DBOX . Spécifie la zone source. Null n’est pas une valeur valide pour ce paramètre.

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.

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 valeurs suivantes : D3DERR _ INVALIDCALL, D3DXERR _ sera déplacé.

Notes

L’écriture sur une surface non-niveau zéro de la texture du volume n’entraîne pas la mise à jour du rectangle de modification. Si D3DXLoadVolumeFromMemory est appelé et que la texture n’a pas déjà été modifiée (ce qui est peu probable dans les scénarios d’utilisation normale), l’application doit appeler explicitement IDirect3DVolumeTexture9 :: AddDirtyBox sur la texture du volume.

Spécifications

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

Voir aussi

D3DXLoadVolumeFromFile

D3DXLoadVolumeFromResource

D3DXLoadVolumeFromVolume

Fonctions de texture dans D3DX 9