Packet Sniffer SDK VCL Edition

HNAdapter :: Methods :: AsyncSendEx

Sends a packet asynchronously.

Syntax:

function AsyncSendEx(hPacket: Pointer;
                       Count: DWORD;
                         Key: Pointer): DWORD;

Parameters:

hPacket

[in] HNPacket object handle.

Count

[in] The number of times this packet must be sent.

Key

[in] A user-defined parameter.

Return values:

HNERR_OK	The packet has been sent successfully.
HNERR_ADAPTER_NOT_OPENED	The adapter has not been opened, see the OpenAdapter method.
HNERR_COUNT_ERR	The Count parameter value must be greater than 0.
HNERR_SIZE_ERR	The PacketSize parameter value is greater than the maximum size, see the MaxPacketSize.
HNERR_ADDR_ERR	pPacket has the wrong value (a memory reading error).
HNERR_ADAPTER_REQ_ERR	An internal driver request error.

Description:

After the network adapter has been opened successfully by OpenAdapter, you can send a raw packet directly, without using the OS functions. This packet will be sent asynchronously. Use OnAsyncSend to assure this packet has been sent successfully.

Having created HNPacket object by HNPacket.AllocatePacket method you can use it to create Raw packet. Note that when using AsyncSendEx function you should set HNPacket.IncPacketSize property correctly, because this property value is used for sending data through the network adapter.

This method cannot work with devices recognized as atWAN. See HNNetAdapterType.