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