RtndDetachRxQueue

RtndDetachRxQueue detaches the specified Receive Queue from the current application process.

Syntax

BOOL RtndDetachRxQueue(
  [in]    ULONG_PTR RtndInterfaceId,
  [in]    ULONG RxQueueIndex,
  [in]    VOID *pRxQueueAppContext
);

Parameters

[in] RtndInterfaceId

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

[in] RxQueueIndex

The index of the Receive Queue.

[in] pRxQueueAppContext

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

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 RtndAttachRxQueue function allocated a context for the calling process, this 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

Requirements

See Also:

• RtndAttachRxQueue
• RtndManageInterface
• RtndShutdownInterface