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

  • Статья

Функция 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 (SRQ) (NDK_SRQ).

[in] SrqDepth

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

[in] NotifyThreshold

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

[in] RequestCompletion

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

[in, optional] RequestContext

Значение контекста, передаваемое в параметр Context функции обратного вызова, указанной в параметре 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
Целевая платформа Windows
Header ndkpi.h (включая Ndkpi.h)
IRQL <=DISPATCH_LEVEL

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

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

NDK_ADAPTER_INFO

NDK_FN_REQUEST_COMPLETION

NDK_SRQ