RtndStartTxQueue

RtndStartTxQueue starts the specified Transmit Queue.

Syntax

BOOL RtndStartTxQueue(
  [in]            ULONG_PTR RtndInterfaceId,
  [in]            ULONG TxQueueIndex,
  [in, ignored]   ULONG Flags
);

Parameters

[in] RtndInterfaceId

The number or pointer used to identify the interface. This value is returned by RtndManageInterface.

[in] TxQueueIndex

The index of the Transmit Queue.

[in, ignored] Flags

Reserved for future use. The value is set to zero by the NL2. Drivers must ignore this parameter.

Return Value

If the function succeeds, it returns TRUE. If the function fails, it returns FALSE. To get extended error information, call GetLastError.

Common error codes:

Note: Custom drivers may return other error codes not listed above.

Remarks

The NL2 always calls this function from the main thread of the NL2 process.

After a successful call to this function, the specified Physical Transmit Queue is expected to be running. It will fetch the buffers of the submitted FIFO, consume them and transmit frames over the wire.

In this function, the driver is expected not only to start the hardware component, but also to reset the DMA ring of the queue so that operations start in a known and clean state.

The NL2 doesn't call these functions before calling RtndStartRxQueue:

• RtndGetTxBuffers
• RtndSubmitTxBuffer
• RtndApplyTxBuffers
• RtndExtractTxBuffer
• RtndReturnTxBuffers

Characteristics

Requirements

See Also:

• RtndManageInterface
• RtndStopTxQueue