Méthode IDirect3DVolume9::LockBox (d3d9.h)

Article
08/23/2023

Verrouille une zone sur une ressource de volume.

Syntaxe

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

Paramètres

[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 une zone à verrouiller. Spécifié par un pointeur vers une structure D3DBOX . La spécification de la valeur NULL pour ce paramètre verrouille l’intégralité 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 IDirect3DVolume9::LockBox est appelé sans D3DLOCK_NO_DIRTY_UPDATE ni D3DLOCK_READONLY. Pour plus d’informations, consultez IDirect3DDevice9::UpdateTexture .

Spécifications


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

Voir aussi

IDirect3DVolume9

IDirect3DVolume9::UnlockBox

Partager via