Méthode IDirect3DCubeTexture9::LockRect (d3d9.h)

Article
08/23/2023

Verrouille un rectangle sur une ressource de texture de cube.

Syntaxe

HRESULT LockRect(
  [in]  D3DCUBEMAP_FACES FaceType,
  [in]  UINT             Level,
  [out] D3DLOCKED_RECT   *pLockedRect,
  [in]  const RECT       *pRect,
  [in]  DWORD            Flags
);

Paramètres

[in] FaceType

Type : D3DCUBEMAP_FACES

Membre du D3DCUBEMAP_FACES type énuméré, identifiant une face de carte de cube.

[in] Level

Type : UINT

Spécifie un niveau de texture de cube mipmapped.

[out] pLockedRect

Type : D3DLOCKED_RECT*

Pointeur vers une structure D3DLOCKED_RECT , décrivant la région à verrouiller.

[in] pRect

Type : const RECT*

Pointeur vers un rectangle à verrouiller. Spécifié par un pointeur vers une structure RECT . La spécification null pour ce paramètre développe la région sale pour couvrir l’intégralité de la texture du cube.

[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

Vous ne pouvez pas spécifier de sous-correction lors de l’utilisation de D3DLOCK_DISCARD. 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. D3DERR_INVALIDCALL est retourné si un ou plusieurs arguments n’est pas valide.

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 IDirect3DCubeTexture9::LockRect est appelé sans D3DLOCK_NO_DIRTY_UPDATE ni D3DLOCK_READONLY. Pour plus d’informations, consultez IDirect3DDevice9::UpdateTexture .

Les textures de cube créées avec D3DPOOL_DEFAULT ne sont pas verrouillables. Les textures de cube créées dans la mémoire vidéo sont verrouillables lorsqu’elles sont créées avec USAGE_DYNAMIC.

Le seul format verrouillable pour une texture de gabarit de profondeur est D3DFMT_D16_LOCKABLE.