Fonction D3DXLoadVolumeFromMemory
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 [in]
-
Type : LPDIRECT3DVOLUME9
Pointeur vers une interface IDirect3DVolume9 . Spécifie le volume de destination, qui reçoit l’image.
-
pDestPalette [in]
-
Type : const PALETTEENTRY*
Pointeur vers une structure PALETTEENTRY , la palette de destination de 256 couleurs ou NULL.
-
pDestBox [in]
-
Type : const D3DBOX*
Pointeur vers une structure D3DBOX . Spécifie la zone de destination. Définissez ce paramètre sur NULL pour spécifier le volume entier.
-
pSrcMemory [in]
-
Type : LPCVOID
Pointeur vers le coin supérieur gauche du volume source en mémoire.
-
SrcFormat [in]
-
Type : D3DFORMAT
Membre du type énuméré D3DFORMAT , format de pixel du volume source.
-
SrcRowPitch [in]
-
Type : UINT
Pitch 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 [in]
-
Type : UINT
Pitch 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 [in]
-
Type : const PALETTEENTRY*
Pointeur vers une structure PALETTEENTRY , palette source de 256 couleurs ou NULL.
-
pSrcBox [in]
-
Type : const D3DBOX*
Pointeur vers une structure D3DBOX . Spécifie la zone source. NULL n’est pas une valeur valide pour ce paramètre.
-
Filtrer [in]
-
Type : DWORD
Combinaison d’une ou de plusieurs D3DX_FILTER contrôle de la façon dont l’image est filtrée. Spécifier D3DX_DEFAULT pour ce paramètre équivaut à spécifier D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER.
-
ColorKey [in]
-
Type : D3DCOLOR
Valeur D3DCOLOR à remplacer par un noir transparent ou 0 pour désactiver la touche de couleur. Il s’agit toujours d’une couleur ARGB 32 bits, indépendamment du format d’image source. Alpha est significatif et doit généralement être défini sur FF pour les touches de couleur opaques. Ainsi, pour le noir opaque, la valeur serait égale à 0xFF000000.
Valeur retournée
Type : HRESULT
Si la fonction réussit, 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_INVALIDDATA.
Notes
L’écriture sur une surface autre que zéro de la texture de volume n’entraîne pas la mise à jour du rectangle sale. Si D3DXLoadVolumeFromMemory est appelé et que la texture n’était pas déjà sale (ce qui est peu probable dans les scénarios d’utilisation normaux), l’application doit appeler explicitement IDirect3DVolumeTexture9::AddDirtyBox sur la texture du volume.
Spécifications
| Condition requise | Valeur |
|---|---|
| En-tête |
|
| Bibliothèque |
|
Voir aussi