RtndDetachTxQueue

RtndDetachTxQueue detaches the specified Transmit Queue from the current application process.

Syntax

Copy
BOOL RtndDetachTxQueue(
  [in]    ULONG_PTR RtndInterfaceId,
  [in]    ULONG TxQueueIndex,
  [in]    VOID *pTxQueueAppContext
);

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] pTxQueueAppContext

The address of the context returned when the calling process called RtndAttachTxQueue.

Return Value

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

Remarks

This function may be called from any process.

If the RtndAttachTxQueue function allocated a context for the calling process, it must be released here.

The driver must not access any register of the NIC in this function.

The driver must anticipate that this function may be called at the same time as, or even after, RtndShutdownInterface. However, it will never be called at the same time or after RtndStopInterface and RtndUnmanageInterface.

Characteristics

Real-time requirements

Deterministic behavior

Not required

Local memory allocation/deallocation restrictions

Process

External MSpace

Internal MSpace

System

Not allowed

Allowed

Process

Allowed

Allowed

Contiguous memory allocation/deallocation restrictions

Contiguous memory

Not allowed

Requirements

Minimum supported version Header

eRTOS 1.0 SDK

Rtnd.h

See Also: