Download SmartLib User Guide

Transcript
ETGetCapturePacket
Description
Dumps the data from a captured packet into a specified location.
Syntax
int ETGetCapturePacket(long PI, int far * Buffer, int BufferSize)
Parameters
PI
long Identifies the packet whose contents are to be read
into Buffer. Packet numbers start at zero.
Buffer
int* (far pointer) Points to an area in memory where the
packet data is to be placed.
BufferSize
int Determines the maximum number of characters to
be put into Buffer.
Return
Value
The return value specifies the number of characters written into Buffer
(not counting NULL, if any) if the function executed successfully. It will
be a positive number greater than or equal to zero. If the return value is
less than zero, then a failure occurred. See Appendix A.
Comments
To determine the number of packets before actually retrieving them, use
ETGetCapturePacketCount(...).
ETGetCapturePacketCount
Description
eturns the number of complete packets captured thus far.
Syntax
long ETGetCapturePacketCount(void)
Parameters
None
Return
Value
This function returns a long integer if it executed correctly. The integer
indicates the number of packets successfully captured by the attached ET1000. If the return value is less than zero, then it is a failure code. See
Appendix A.
Comments
If in Continuous Capture mode, you must stop capture before getting the
CapturePacketCount.
ETGetCaptureParams
Description
Returns the current capture parameters.
Syntax
int ETGetCaptureParams(CaptureStructure* CStruct)
Parameters
CStruct
Return
Value
The return value is >= 0 if the function executed successfully. The return
value is < 0 if the function failed. See Appendix A.
Comments
Use function ETCaptureParams to define the capture parameters on the
attached ET-1000. You need not define the capture parameters before
calling this function. The information returned in the CaptureStructure
structure represents the current setup on the attached ET-1000. See the
definition of CaptureStructure in the Data Structures portion of this
manual.
84
CaptureStructure* Pointer to the CaptureStructure
structure that is to hold the capture parameters.
SmartLib User Guide