Packet Sniffer SDK DLL Edition

HNAdapter :: Methods :: AdpGetTranWithErr

 Previous Next

Returns the number of the packets transferred by the network adapter with errors.

Syntax:

DWORD __stdcall AdpGetTranWithErr(HANDLE hAdp, DWORD *HiValue);

Parameters:

hAdp

[in] HNAdapter object handle.

HiValue

[out] The pointer to the variable, in which the high DWORD of the result will be stored. May be set to NULL, if the application does not need these data.

Return values:

If the function succeeds, the return value will be the low-order doubleword of the number of the packets transferred by the network adapter with errors, and if HiValue is non-NULL, the function will put the high-order doubleword of this number into the variable pointed to by this parameter.

Description:

Use AdpGetTranWithErr after opening the network adapter and executing the AdpUpdateAdapterStatistics function.

This function returns the value of the HNAdapter internal packets counter. This value is set with the PSSDK internal driver packets counter value syncronously after AdpUpdateAdapterStatistics function call. So, to get the latest packets counter value you should call AdpGetTranWithErr immediately after AdpUpdateAdapterStatistics function call.

See also:HNAdapter, AdpOpenAdapter, AdpUpdateAdapterStatistics