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

Статья
08/07/2023

Функция 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

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

[in, optional] RequestContext

Значение контекста, передаваемое параметру Context функции обратного вызова, указанной в параметре 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	Запрос завершился сбоем из-за нехватки ресурсов. Важно Запрос может завершиться как встроенным, так и асинхронным с этим кодом состояния.
Другие коды состояния	Произошла ошибка.

Требования

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

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

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

NDK_ADAPTER_INFO

NDK_CQ

NDK_CQ_DISPATCH

NDK_FN_REQUEST_COMPLETION