ID3DXPatchMesh::LockVertexBuffer Method

Lock the vertex buffer.

Syntax

HRESULT LockVertexBuffer(      

    DWORD Flags,
    VOID **ppData
);

Parameters

Flags

[in] 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_NO_SYSLOCK
• D3DLOCK_READONLY
• D3DLOCK_NOOVERWRITE

For a description of the flags, see D3DLOCK.

ppData

[out, retval] VOID* pointer to a memory buffer containing the returned vertex data.

Return Value

If the method succeeds, the return value is D3D_OK.

If the method fails, the return value can be one of the following values.

D3DERR_INVALIDCALL	The method call is invalid. For example, a method's parameter may have an invalid value.
E_OUTOFMEMORY	Microsoft?Direct3D?could not allocate sufficient memory to complete the call.

Remarks

The vertex buffer is usually locked, written to, and then unlocked for reading.

Patch meshes use 16-bit index buffers.