Download netANALYZER API - Windows XP/Vista/7/8

API Definitions
3.3.19
40/60
netana_start_capture
Start a live capture. This function must be called after all ports and GPIOs have been correctly
configured.
Note: Always call the function netana_set_filelist, before calling netana_start_capture, if
capturing to file is intended.
INT32 netana_start_capture(
NETANA_HANDLE hDev,
UINT32 ulCaptureMode,
UINT32 ulPortEnableMask,
UINT32 ulMacMode,
UINT64 ullReferenceTime,
PFN_STATUS_CALLBACK pfnStatus,
PFN_DATA_CALLBACK pfnData,
void* pvUser);
Parameter
Description
hDev
Device handle
ulCaptureMode
0: NETANA_CAPTUREMODE_DATA
- Capture whole Ethernet frames
1: NETANA_CAPTUREMODE_TIMESTAMPS
- Only capture timestamps (reception time) of incoming frames.
2: NETANA_CAPTUREMODE_HIGHLOAD
- A special mode for measurements to capture reduced frames at very high
network load. In order to avoid PCI bus overload, all frames are truncated to a
length of 58 bytes! See description below!
0x80000000: NETANA_CAPTUREMODE_RINGBUFFER
- Set this bit to enable data capturing in ringbuffer mode (only valid for capturing to
file)
ulPortEnableMask
Bitmask of enabled Ethernet ports. Each bit represents a port.
ulMacMode
0: NETANA_MACMODE_ETHERNET
- Capture IEEE 802.3 frames in Ethernet mode
1: NETANA_MACMODE_TRANSPARENT
- Capture all bytes on Ethernet without regarding any specifications
ullReferenceTime
Capture reference time in nanoseconds.
This value is expected to be the UNIX time (Seconds since 1.1.1970) in
nanoseconds, as Wireshark expects this format.
Note: When using a non-UNIX reference time, conversion
with the standard tools will produce a wrong timestamp.
When using customer tools, the reference time may by set
to any customer value.
pfnStatus
Status change notification callback. Set to NULL if not needed when registering
callback note the following restrictions.
pfnData
Callback for captured data. Set to NULL if not needed.
Note: If this parameter is NULL, a capturing file needs to be
set via netana_set_filelist when registering callback note
the following restrictions.
pvUser
User parameter passed on callbacks
netANALYZER API | Windows XP/Vista/7/8
DOC091113DRV07EN | Revision 7 | English | 2014-05 | Released | Public
© Hilscher, 2009-2014