NDK_FN_ARM_CQ callback function

The NdkArmCq (NDK_FN_ARM_CQ) function arms an NDK completion queue (CQ) notification.

Syntax


NDK_FN_ARM_CQ NdkArmCq;

VOID NdkArmCq(
  _In_ NDK_CQ *pNdkCq,
  _In_ ULONG  Type
)
{ ... }

Parameters

pNdkCq [in]

A pointer to an NDK completion queue object (NDK_CQ).

Type [in]

The type of notification to arm. The following notification types are defined:

TermDescription

NDK_CQ_NOTIFY_ERRORS

Notify if there are any completion queue errors such as a completion queue overrun or catastrophic failure.

NDK_CQ_NOTIFY_ANY

Notify of the next successful completion in the completion queue.

NDK_CQ_NOTIFY_SOLICITED

Notify when the completion queue receives a send request that includes the ND_OP_FLAG_SEND_AND_SOLICIT_EVENT flag.

 

Return value

None

Remarks

After the NDK consumer arms a completion queue (CQ) notification, the provider calls the NdkCqNotificationCallback callback function (the NDK_FN_CQ_NOTIFICATION_CALLBACK routine that the consumer specified when the CQ was created with the NdkCreateCq (NDK_FN_CREATE_CQ) function) when the specified type of notification is due.

If the CQ is closed while a call to NdkCqNotificationCallback is in-progress, the close request will remain pending until NdkCqNotificationCallback returns control to the provider. After the close request is completed, the provider will not call NdkCqNotificationCallback.

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

See also

NDK_CQ
NDK_CQ_DISPATCH
NDK_FN_CQ_NOTIFICATION_CALLBACK
NDK_FN_CREATE_CQ
NDKPI Completion Handling Requirements

 

 

Send comments about this topic to Microsoft

Show: