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

Статья
02/07/2025

Функция NdkModifySrq (NDK_FN_MODIFY_SRQ) изменяет пороговое значение размера и уведомления NDK общей очереди получения (SRQ).

Синтаксис

NDK_FN_MODIFY_SRQ NdkFnModifySrq;

NTSTATUS NdkFnModifySrq(
  [in]           NDK_SRQ *pNdkSrq,
  [in]           ULONG SrqDepth,
  [in]           ULONG NotifyThreshold,
  [in]           NDK_FN_REQUEST_COMPLETION RequestCompletion,
  [in, optional] PVOID RequestContext
)
{...}

Параметры

[in] pNdkSrq

Указатель на объект NDK shared receive queue (SRQ) (NDK_SRQ).

[in] SrqDepth

Новый размер SRQ. Новый размер должен быть меньше или равен размеру, указанному в элементе MaxSrqDepth структуры NDK_ADAPTER_INFO. Размер нуля означает, что изменение глубины не запрашивается. То есть необходимо сохранить существующее значение глубины SRQ.

[in] NotifyThreshold

Количество запросов на получение в очереди, которое активирует обратный вызов уведомления SRQ. Если это значение больше нуля, поставщик NDK должен перенаставить уведомление SRQ, чтобы активировать, когда число запросов в очереди падает ниже указанного значения. Если число запросов приема в очереди уже ниже порогового значения во время вызова этой функции, необходимо создать уведомление SRQ. После создания уведомления SRQ дальнейшие уведомления будут разоружаться, пока потребитель NDK снова не вызовет эту функцию с ненулевым пороговым значением. Если задано пороговое значение нуля, поставщик должен сохранить текущее пороговое значение уведомления SRQ и состояние arming.

[in] RequestCompletion

Указатель на подпрограмму обратного вызова завершения запроса NdkRequestCompletion (NDK_FN_REQUEST_COMPLETION).

[in, optional] RequestContext

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

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

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

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

Замечания

NdkModifySrq изменяет пороговое значение размера и уведомления для объекта NDK общего приема (SRQ) (NDK_SRQ).

Требования

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

См. также

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

NDK_ADAPTER_INFO

NDK_FN_REQUEST_COMPLETION

NDK_SRQ

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