The Virtual Interface Architecture
Providing guidance for both developers and users of large clustered systems, this book explains how VI provides a new interface between applications and switched interconnect hardware.
TABLE OF CONTENTS The Virtual Interface Architecture
Completion Queue Management
VipCreateCQ
Synopsis
VIP_RETURN VipCreateCQ( IN VIP_NIC_HANDLE NicHandle, IN VIP_ULONG EntryCount, OUT VIP_CQ_HANDLE *CQHandle ) <a name="363"></a><a name="wbp11AppaP745"></a>
Parameters
| NicHandle : | The handle of the associated NIC. |
| EntryCount : | The number of completion entries that this Completion Queue will hold. |
| CQHandle : | Returned to the caller. The handle of the newly created Completion Queue. |
Description
VipCreateCQ creates a new Completion Queue. The caller must specify the minimum number of completion entries that the queue must contain. If successful, it returns a handle to the newly created Completion Queue. A Completion queue is created with at least the specified number of completion entries. To avoid dropped completion notifications, applications should make sure that the number of operations posted on send/receive queues attached to a completion queue does not exceed the completion queue capacity at any time. A common technique to deal with this in multi-threaded environments is to use atomic increment/decrement variables to keep track of the available space in completion queues.
Returns
VIP_SUCCESS A new Completion Queue was successfully created.
VIP_INVALID_PARAMETER The NIC handle was invalid.
VIP_ERROR_RESOURCE The Completion Queue could not be created due to insufficient resources.
VipDestroyCQ
Synopsis
VIP_RETURN VipDestroyCQ( IN...
Copyright Intel Corporation 2002 under license agreement with Books24x7
