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

Статья
02/07/2025

Функция NdkResizeCq (NDK_FN_RESIZE_CQ) изменяет размер очереди завершения NDK (CQ).

Синтаксис

NDK_FN_RESIZE_CQ NdkFnResizeCq;

NTSTATUS NdkFnResizeCq(
  [in]           NDK_CQ *pNdkCq,
  [in]           ULONG CqDepth,
  [in]           NDK_FN_REQUEST_COMPLETION RequestCompletion,
  [in, optional] PVOID RequestContext
)
{...}

Параметры

[in] pNdkCq

Указатель на объект очереди завершения NDK (CQ) (NDK_CQ).

[in] CqDepth

Новое число записей завершения, которые может содержать CQ. Размер CQ должен быть меньше или равен значению, указанному в элементе MaxCqDepth в структуре NDK_ADAPTER_INFO.

[in] RequestCompletion

Указатель на функцию NdkRequestComplet ion (NDK_FN_REQUEST_COMPLETION).

[in, optional] RequestContext

Значение контекста, передаваемое параметру контекста функции обратного вызова, указанной в параметре RequestCompletion.

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

Функция NDK_FN_RESIZE_CQ возвращает один из следующих кодов NTSTATUS.

Возвращаемый код	Описание
STATUS_SUCCESS	CQ был успешно изменен.
STATUS_PENDING	Операция ожидается и будет завершена позже. Драйвер вызовет указанную функцию RequestCompletion (NDK_FN_REQUEST_COMPLETION) для завершения ожидающей операции.
STATUS_INVALID_PARAMETER	Сбой запроса, так как размер CQ, указанный в параметре CqDepth, больше значения в элементе MaxCqDepth в структуре NDK_ADAPTER_INFO.
STATUS_INSUFFICIENT_RESOURCES	Сбой запроса из-за нехватки ресурсов. Важные запрос может завершиться сбоем, а также асинхронно с этим кодом состояния.
Другие коды состояния	Произошла ошибка.

Замечания

NdkResizeCq изменяет количество записей завершения, которые может содержать CQ.

Требования

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

См. также

требования к времени существования объекта NDKPI

NDK_ADAPTER_INFO

NDK_CQ

NDK_CQ_DISPATCH

NDK_FN_REQUEST_COMPLETION

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