lgo_InitializeStack()

Prepare the protocol stack and communications hardware for processing.

#include "laygo.h"

LResult lgo_InitializeStack
    (
        void
    );

lgo_InitializeStack() prepares the protocol stack and communications hardware for processing. During high-speed transmission using small frames, more frequent activation of the protocol stack may be required to maintain high throughput. When stack activation is too infrequent, the hardware receive queue empties and the hardware initiates flow control when this option is available. This will be seen as a series of XOFF/XON events on the physical layer.

The stack is initially disabled. lgo_EnableStack() must be called to enable stack processing.

The stack can only be configured before initialization.

If successful, lgo_InitializeStack() returns a non-negative value. Otherwise, it returns a negative value indicating the reason it failed. Possible unsuccessful return values are:

• lgo_ERROR_BUFFER_POOL_INITIALIZATION_FAILURE
• lgo_ERROR_HARDWARE_INITIALIZATION_FAILURE
• lgo_ERROR_STACK_INITIALIZATION_FAILURE
• lgo_ERROR_INVALID_DRIVER_VERSION
• lgo_ERROR_INVALID_HARDWARE_VERSION

lgo_ConfigureStack()
lgo_EnableStack()
lgo_UninitializeStack()

LResult    result;

result = lgo_InitializeStack();

if (result < 0)
{
    return (FAILURE);
}