NDK_FN_SRQ_NOTIFICATION_CALLBACK callback function (ndkpi.h)

Article
10/21/2021

The NdkSrqNotificationCallback (NDK_FN_SRQ_NOTIFICATION_CALLBACK) function provides NDK shared receive queue (SRQ) notifications from an NDK provider.

Syntax

NDK_FN_SRQ_NOTIFICATION_CALLBACK NdkFnSrqNotificationCallback;

void NdkFnSrqNotificationCallback(
  [in, optional] PVOID SrqNotificationContext,
  [in]           NTSTATUS SrqStatus
)
{...}

Parameters

[in, optional] SrqNotificationContext

A context area that was specified in the SrqNotificationContext parameter of the NdkCreateSrq (NDK_FN_CREATE_SRQ) function when the SRQ object was created.

[in] SrqStatus

Indicates if a fatal SRQ error occurred. The following status codes are defined:

Term	Description
STATUS_SUCCESS	The SRQ is operating normally.
STATUS_INTERNAL_ERROR	A catastrophic error occurred on the SRQ. The SRQ is unusable. All of the associated queue pairs (QPs) are also unusable. No future completions will be reported. This error usually indicates a hardware error.

Return value

None

Remarks

Note This routine is implemented by the NDK consumer and passed to the NDK provider.

An NDK provider calls the NdkSrqNotificationCallback function when the number of receive requests that are queued on the SRQ falls below the minimum number of queued receive requests (NotifyThreshold). The NotifyThreshold is an input parameter to the NdkCreateSrq (NDK_FN_CREATE_SRQ) and NdkModifySrq (NDK_FN_MODIFY_SRQ) functions.

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

Share via