nngxCmdlistStorageRaw Function

Syntax

NNGX_APICALL void NNGX_APIENTRY nngxCmdlistStorageRaw(
     nngxCommandList * cmdlist,
     GLsizei bufsize,
     GLvoid * commandbuffer,
     GLsizei requestcount,
     GLvoid * commandrequest
);

Arguments

Name Description
in cmdlist The target command list object.
in bufsize Size of the 3D command buffer in bytes.
in commandbuffer Pointer to the region to use as the 3D command buffer.
in requestcount Number of command requests.
in commandrequest Pointer to the region to use as the command request heap.

Return Values

No values are returned.

Description

Allocates the data region for the specified command list.

This is the directly specified command list version of nngxCmdlistStorage.

Whereas with nngxCmdlistStorage, an allocator is called inside the library to allocate a buffer region, but with this function, the buffer region is given directly as a function parameter. Be sure not to deallocate the buffer that is given here while the command list is still in use. You can use the nngxGetCommandRequestSizeRaw function to get the size of area you need for the command request buffer.

The buffer region specified with commandbuffer must be allocated in device memory, and must be specified with a 16-byte aligned address. There are no restrictions on the memory allocated for the buffer region specified with commandrequest, and the region must be specified with a 4-byte aligned address.

Revision History

2012/06/14
Added a note about the buffer region alignment conditions.
2012/05/09
Initial version.

CONFIDENTIAL