ID3DXMesh::LockAttributeBuffer method

Locks the mesh buffer that contains the mesh attribute data, and returns a pointer to it.

Syntax

HRESULT LockAttributeBuffer(
  [in]  DWORD Flags,
  [out] DWORD **ppData
);

Parameters

Flags [in]

Type: DWORD

Combination of zero or more locking flags that describe the type of lock to perform. For this method, the valid flags are:

  • D3DLOCK_DISCARD
  • D3DLOCK_NO_DIRTY_UPDATE
  • D3DLOCK_NOSYSLOCK
  • D3DLOCK_READONLY

For a description of the flags, see D3DLOCK.

ppData [out]

Type: DWORD**

Address of a pointer to a buffer containing a DWORD for each face in the mesh.

Return value

Type: HRESULT

If the method succeeds, the return value is D3D_OK. If the method fails, the return value can be D3DERR_INVALIDCALL.

Remarks

If ID3DXMesh::Optimize has been called, the mesh will also have an attribute table that can be accessed using the ID3DXBaseMesh::GetAttributeTable method.

Requirements

Requirement Value
Header
D3DX9Mesh.h
Library
D3dx9.lib

See also

ID3DXMesh

ID3DXMesh::UnlockAttributeBuffer

ID3DXBaseMesh::GetAttributeTable

ID3DXMesh::SetAttributeTable