NDK_FN_RECEIVE callback function (ndkpi.h)

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

Syntax

NDK_FN_RECEIVE NdkFnReceive;

NTSTATUS NdkFnReceive(
  [in]           NDK_QP *pNdkQp,
  [in, optional] PVOID RequestContext,
                 const NDK_SGE *pSgl,
  [in]           ULONG nSge
)
{...}

Parameters

[in] pNdkQp

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

[in, optional] RequestContext

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.

[in] nSge

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 code Description
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

Requirement Value
Minimum supported client None supported,Supported in NDIS 6.30 and later.
Minimum supported server Windows Server 2012
Target Platform Windows
Header ndkpi.h (include Ndkpi.h)
IRQL <=DISPATCH_LEVEL

See also

NDKPI Work Request Posting Requirements

NDK_QP

NDK_RESULT

NDK_SGE