Edit

NDK_FN_SRQ_NOTIFICATION_CALLBACK callback function (ndkpi.h)

  • Article

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