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

Статья
02/26/2024

Функция 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 непригоден для использования. Все связанные пары очередей (QP) также непригодны для использования. О будущих завершениях сообщать не будет. Ошибка STATUS_BUFFER_OVERFLOW обычно указывает на ошибку программирования.
STATUS_INTERNAL_ERROR	Указывает, что в CQ произошла неустранимая ошибка, и CQ непригодный для использования. Все связанные пары очередей (QP) также непригодны для использования. О будущих завершениях сообщать не будет. Ошибка STATUS_INTERNAL_ERROR обычно указывает на аппаратную ошибку.

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

None

Remarks

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

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

Требования

Требование	Значение
Минимальная версия клиента	Не поддерживается, поддерживается в NDIS 6.30 и более поздних версиях.
Минимальная версия сервера	Windows Server 2012
Целевая платформа	Windows
Header	ndkpi.h (включая Ndkpi.h)
IRQL	<=DISPATCH_LEVEL

См. также раздел

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

NDK_FN_CREATE_CQ

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