NDK_FN_SRQ_NOTIFICATION_CALLBACK callback function

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 NdkSrqNotificationCallback;

VOID NdkSrqNotificationCallback(
  _In_opt_ PVOID    SrqNotificationContext,
  _In_     NTSTATUS SrqStatus
)
{ ... }

Parameters

SrqNotificationContext [in, optional]

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

SrqStatus [in]

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

TermDescription

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

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

 

 

Send comments about this topic to Microsoft

Show: