NDK_FN_RECEIVE routine

The NdkReceive (NDK_FN_RECEIVE) function posts a receive request on an NDK queue pair (QP).

Syntax


NDK_FN_RECEIVE NdkReceive;

NTSTATUS NdkReceive(
  _In_      NDK_QP *pNdkQp,
  _In_opt_  PVOID RequestContext,
  _In_reads_(nSge) CONST NDK_SGE *pSgl,
  _In_      ULONG nSge
)
{ ... }

Parameters

pNdkQp [in]

A pointer to an NDK queue pair (QP) object (NDK_QP).

RequestContext [in, optional]

A context value to be returned in the RequestContext member of the NDK_RESULT structure for this request.

pSgl

An array of SGE structures (NDK_SGE) that represent the buffers to receive incoming data.

nSge [in]

The number of SGE structures in the array that is specified in the pSgl parameter.

Return value

The NdkReceive function returns one of the following NTSTATUS codes.

Return codeDescription
STATUS_SUCCESS

The request was posted successfully. A completion entry will be queued to the CQ when the work request is completed.

Other status codes

An error occurred.

 

Remarks

NdkReceive posts a receive request on a queue pair (QP).

Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2012

Version

Supported in NDIS 6.30 and later.

Header

Ndkpi.h (include Ndkpi.h)

IRQL

<=DISPATCH_LEVEL

See also

NDK_QP
NDK_RESULT
NDK_SGE
NDKPI Work Request Posting Requirements

 

 

Send comments about this topic to Microsoft

Anzeigen:
© 2014 Microsoft