функция обратного вызова NDK_FN_CQ_NOTIFICATION_CALLBACK (ndkpi.h)

Статья
02/07/2025

Функция NdkCqNotificationCallback (NDK_FN_CQ_NOTIFICATION_CALLBACK) вызывается поставщиком NDK, чтобы уведомить потребителя о событии очереди завершения (CQ).

Синтаксис

NDK_FN_CQ_NOTIFICATION_CALLBACK NdkFnCqNotificationCallback;

void NdkFnCqNotificationCallback(
  [in, optional] PVOID CqNotificationContext,
  [in]           NTSTATUS CqStatus
)
{...}

Параметры

[in, optional] CqNotificationContext

Область контекста, указанная в параметре CqNotificationContext функцииNdkCreateCq (NDK_FN_CREATE_CQ) при создании объекта очереди завершения (CQ).

[in] CqStatus

Указывает состояние ошибки CQ. Определены следующие коды состояния:

Срок	Описание
STATUS_SUCCESS	Указывает, что CQ работает нормально.
STATUS_BUFFER_OVERFLOW	Указывает больше завершения, чем это максимальное, что CQ может содержаться в очереди в CQ, и CQ недоступен. Все связанные пары очередей (QPs) также недоступны. О будущих завершениях не будет сообщено. Ошибка STATUS_BUFFER_OVERFLOW обычно указывает на ошибку программирования.
STATUS_INTERNAL_ERROR	Указывает, что в CQ произошла неустранимая ошибка, и CQ не используется. Все связанные пары очередей (QPs) также недоступны. О будущих завершениях не будет сообщено. Ошибка STATUS_INTERNAL_ERROR обычно указывает на ошибку оборудования.

Возвращаемое значение

Никакой

Замечания

Поставщик NDK вызывает NdkCqNotificationCallback, чтобы уведомить потребителя о событии очереди завершения (CQ).

Потребитель NDK указал функцию NdkCqNotificationCallbackв параметре CqNotificationContext функции NdkCreateCq (NDK_FN_CREATE_CQ) при создании объекта очереди завершения (CQ).

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Не поддерживается, поддерживается в NDIS 6.30 и более поздних версиях.
минимальный поддерживаемый сервер	Windows Server 2012
целевая платформа	Виндоус
заголовка	ndkpi.h (include Ndkpi.h)
IRQL	<=DISPATCH_LEVEL

См. также

Требования к обработке NDKPI

NDK_FN_CREATE_CQ

Поделиться через