INDAdapter::CreateCompletionQueue Method

Article
07/02/2010

Allocates a completion queue.

Syntax

HRESULT CreateCompletionQueue(
  [in]   SIZE_T nEntries,
  [out]  INDCompletionQueue **ppCq
);

Parameters

nEntries [in]
The number of completion queue entries to support. The value must be greater than zero and less than the MaxCqSize member of the ND_ADAPTER_INFO structure.
ppCq [out]
An INDCompletionQueue interface to the completion queue.

Return Value

When you implement this method, you should return the following return values. If you return others, try to use well-known values to aid in debugging issues.

Return code	Description
ND_SUCCESS	The operation completed successfully.
ND_NO_MEMORY	There was not enough memory to create the completion queue.
ND_INSUFFICIENT_RESOURCES	There was not enough hardware resources to create the completion queue.
ND_INVALID_PARAMETER	The adapter cannot support the requested number of entries.
ND_DEVICE_REMOVED	The underlying Network Direct adapter was removed from the system. Only cleanup operations on the Network Direct adapter will succeed.

Remarks

You must create at least one completion queue. You can create one for inbound requests and another for outbound requests, or you can use the same queue for both. You specify the completion queue when you call INDConnector::CreateEndpoint to create an endpoint.

More than one endpoint can can specify the same completion queue.

Requirements

Product	Microsoft Message Passing Interface (MS-MPI)
Header	Ndspi.h