Méthode IDirect3DVolumeTexture9::LockBox (d3d9helper.h)

Article
08/23/2023

Verrouille une zone sur une ressource de texture de volume.

Syntaxe

HRESULT LockBox(
  [in]  UINT          Level,
  [out] D3DLOCKED_BOX *pLockedVolume,
  [in]  const D3DBOX  *pBox,
  [in]  DWORD         Flags
);

Paramètres

[in] Level

Type : UINT

Spécifie le niveau de la ressource de texture de volume à verrouiller.

[out] pLockedVolume

Type : D3DLOCKED_BOX*

Pointeur vers une structure D3DLOCKED_BOX décrivant la région verrouillée.

[in] pBox

Type : const D3DBOX*

Pointeur vers le volume à verrouiller. Ce paramètre est spécifié par un pointeur vers une structure D3DBOX . La spécification de NULL pour ce paramètre verrouille l’intégralité du niveau du volume.

[in] Flags

Type : DWORD

Combinaison de zéro ou plusieurs indicateurs de verrouillage qui décrivent le type de verrou à effectuer. Pour cette méthode, les indicateurs valides sont les suivants :

D3DLOCK_DISCARD
D3DLOCK_NO_DIRTY_UPDATE
D3DLOCK_NOSYSLOCK
D3DLOCK_READONLY

Pour obtenir une description des indicateurs, consultez D3DLOCK.

Valeur retournée

Type : HRESULT

Si la méthode réussit, la valeur de retour est D3D_OK. Si la méthode échoue, la valeur de retour peut être D3DERR_INVALIDCALL.

Notes

Pour des raisons de performances, sale régions sont enregistrées uniquement pour le niveau zéro d’une texture. Les régions sales sont automatiquement enregistrées lorsque LockBox est appelé sans D3DLOCK_NO_DIRTY_UPDATE ni D3DLOCK_READONLY. Pour plus d’informations, consultez UpdateTexture.

Spécifications


Plateforme cible	Windows
En-tête	d3d9helper.h (inclure D3D9.h)
Bibliothèque	D3D9.lib

Voir aussi

IDirect3DVolumeTexture9

UnlockBox

Partager via