Dialogic 6.2 Manuale Utente

BfvLineDumpStructure

November 2009

93

The BfvLineDumpStructure function (Volume 1, Bfv API 

Reference Manual) dumps the contents of the BTLINE structure into 

a file. It writes each element of the line structure individually.

Use this call to create error report logs (along with the contents of 

Dump History) and to track changing states of the line.

Dump History (dh) is a stand-alone utility, which displays to the 

screen a log of the interactions between the driver and channels, 

modules, and applications. The size is specified at driver 

configuration time. The default is a buffer size of approximately 1MB 

for the entire driver.

To use the Dump History utility, you must enable the debug option 

during installation of the driver. See Chapter 1, Manually 

Configuring the Driver on Windows® in your installation and 

configuration guide for instructions on how to enable the debug 

option. Once enabled, driver operations are automatically logged 

with a time stamp in a circular buffer.

Using dump history, in any form, can have effect on the system. 

Enabling history at all, regardless of the configured size, slows the 

operation of the driver down to a small degree. If the history size is 

set to a very large value (e.g., a number of megabytes), then actually 

getting the history slows the system down in ways that affects any 

other Bfv API applications running.

This is because of several factors:

„

The driver requires time to copy history memory. All other 

standard driver operations are temporarily suspended.

„

The history functions require time to parse the history memory 

into readable form.

„

High disk load while writing the many megabytes of history data 

in a short time.