INDCompletionQueue Interface

Use to indicate the completion of an outstanding request, for example, a Send or Receive request.

The INDAdapter::CreateCompletionQueue method returns this interface.

Members

The INDCompletionQueue interface inherits from INDOverlapped. INDCompletionQueue also defines the following types of members:

  • Methods

Methods

The INDCompletionQueue interface defines the following methods.

Method Description
Resize

Modifies the number of results entries that a completion queue supports.

Notify

Requests notification for errors and completions.

GetResults

Retrieves the request completion results from the completion queue.

 

Remarks

Outbound and inbound request queues of one or more endpoints can be bound to a single completion queue. Outbound and inbound request queues of a single endpoint can be bound to different completion queues. Completion queues operate in a similar manner to I/O completion ports, but specific to endpoint data transfer operations. Completion Queues can have completion notification events sent to I/O completion ports.

I/O requests do not use the traditional OVERLAPPED mechanisms, but do provide the user the ability to associate a similar structure, ND_RESULT, with each I/O request that is returned via the completion queue when that request completes. I/O requests can be issued and processed without any kernel transitions. Likewise, I/O completions can also be detected and processed without any kernel transitions.

Requirements

Product

Microsoft Message Passing Interface (MS-MPI)

Header

Ndspi.h

See Also

INDConnector::CreateEndpoint

 

 

Send comments about this topic to Microsoft

Build date: 7/2/2010