D3DXLoadVolumeFromVolume fonction)
Charge un volume à partir d’un autre volume.
Syntaxe
HRESULT D3DXLoadVolumeFromVolume(
_In_ LPDIRECT3DVOLUME9 pDestVolume,
_In_ const PALETTEENTRY *pDestPalette,
_In_ const D3DBOX *pDestBox,
_In_ LPDIRECT3DVOLUME9 pSrcVolume,
_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.
-
pSrcVolume [ dans]
-
Type : LPDIRECT3DVOLUME9
Pointeur vers une interface IDirect3DVolume9 . Spécifie le volume source.
-
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. Affectez la valeur null à ce paramètre pour spécifier la totalité du volume.
-
Filtre [ dans]
-
Type : DWORD
Combinaison d’un ou de plusieurs _ filtres D3DX, qui contrôle 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 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 D3DXLoadVolumeFromVolume 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 IDirect3DVolumeTexture9 :: AddDirtyBox sur l’aire.
Spécifications
| Condition requise | Valeur |
|---|---|
| En-tête |
|
| Bibliothèque |
|