beautypg.com

Memunlock, Performance figures, Handling errors – Sundance SMT6025 v.2.9 User Manual

Page 40: Exported functions, 21 performance figures, 22 handling errors

background image

Version 2.9

Page 40 of 45

SMT6025 User Manual

the variable contains the actual number of MDL entries
used to describe the memory locked.

Return value

The function returns a pointer to the locked down memory, or zero on
failure. The function may fail if you are requesting the MDL list, but do not
provide enough storage for all the MDLs required to describe the locked
down memory. In this case, nEntCnt will contain the number of MDL entries
required to describe the memory.

20.2 MemUnlock

Free a contiguous region of memory that was previously allocated by a call to
MemLock().

Prototype

void IFHw::MemUnlock( void *pMem )

Parameters

pMem

Pointer to the memory to unlock.

21 Performance figures

The table below shows typical performance figures obtained with the

SMT6025.

Transfer type

Read [MB/s]

Write [MB/s]

HSC with contiguous memory.

46

40

HSC with Scatter/Gather memory.

40

32

Host comport

2

2

Table 3 - Typical performance figures for various transfer types

22 Handling errors

22.1 Exported functions

Most of the functions exported by SmtDrv.dll return status values. You should
always check the return values from these functions. SmtGetError() can be
used to translate the return values into text strings.
The following is a sample segment to show how to use the functions exported
by SmtDrv.dll.

User Manual (QCF42); Version 2.9, 22/02/02; © Sundance Multiprocessor Technology Ltd. 2002

This manual is related to the following products: