NDK_FN_RECEIVE callback function (ndkpi.h)

Article
02/22/2024

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