SetGevMode

Description

Selects the packet transfer optimization mode.

[C++]
int SetTransferMode(unsigned short transferMode);


Parameters [C/C++]

[in] unsigned short gevMode

Transfer mode to be set. Can be one of the following values:

TRANSFER_SINGLE - transfer of network packets is optimized for streaming via a single network interface

TRANSFER_MULTI - transfer of network packets is optimized for streaming via multiple network interfaces

Return Values

S_OK

Success

E_FAIL

Failure

Example

This fragment of code instantiates a camera object and sets the packet transfer mode:

static CGevCamera* m_pCamera;

m_pCamera = createCamera();

m_pCamera->SetTransferMode(TRANSFER_MULTI);

Remarks

GigESim utilizes two different methods for transferring images to the network. The single transfer mode results in efficient transmission when a single network interface is used to stream images to a remote node, but it can cause a reduction of the link speed on Windows XP and Windows 7 when several virtual cameras are streaming simultaneously via multiple network interfaces. In the latter case the multi-transfer mode must be selected for the optimal performance.

If this function is not called, GigESim will be using the single transfer mode.

This function is not used in the Linux version of GigESim.

Note that the camera must be in the disconnected state in order for SetTransferMode to work.