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

Статья
02/07/2025

Функция NdkInvalidate (NDK_FN_INVALIDATE) делает недопустимой область памяти NDK (MR) или окно памяти (MW).

Синтаксис

NDK_FN_INVALIDATE NdkFnInvalidate;

NTSTATUS NdkFnInvalidate(
  [in]           NDK_QP *pNdkQp,
  [in, optional] PVOID RequestContext,
  [in]           NDK_OBJECT_HEADER *pNdkMrOrMw,
  [in]           ULONG Flags
)
{...}

Параметры

[in] pNdkQp

Указатель на объект пары очередей NDK (QP) (NDK_QP).

[in, optional] RequestContext

Значение контекста, возвращаемое в RequestContext член структуры NDK_RESULT для этого запроса.

[in] pNdkMrOrMw

Указатель на объект области памяти (MR) (NDK_MR) или объект памяти (MW) (NDK_MW), указанный в структуре NDK_OBJECT_HEADER. Если задан объект MR, объект MR должен быть зарегистрирован в функции NdkFastRegister (NDK_FN_FAST_REGISTER). Потребитель NDK никогда не должен указывать объект MR, зарегистрированный с помощью функции NdkRegister (NDK_FN_REGISTER) в параметре pNdkMrOrMw. Доступ к объектам MR, зарегистрированным с помощью функции NdkRegister (NDK_FN_REGISTER)), можно удалить с помощью функции NdkDeregisterMr (NDK_FN_DEREGISTER_MR).

[in] Flags

Побитовое ИЛИ флагов, указывающее разрешенные операции. Поддерживаются следующие флаги:

Ценность	Значение
NDK_OP_FLAG_SILENT_SUCCESS 0x00000001	Указывает, что успешное завершение этого запроса не создает событие завершения в очереди исходящего завершения. Однако запросы, которые завершаются сбоем, создают событие в очереди завершения.
NDK_OP_FLAG_READ_FENCE 0x00000002	Указывает, что все предыдущие запросы на чтение должны быть завершены, прежде чем оборудование начнет обработку этого запроса.
NDK_OP_FLAG_DEFER 0x00000200	Указывает поставщику NDK, что он может отложить запрос на оборудование для обработки. Дополнительные сведения об этом флаге см. в схемы отложенной обработки NDKPI. Примечание Этот флаг поддерживается только в NDKPI 1.2 (Windows Server 2012 R2) и более поздних версиях.

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

Тем
функция NdkInvalidate возвращает один из следующих кодов NTSTATUS.

Возвращаемый код	Описание
STATUS_SUCCESS	Запрос был успешно размещен. Запись завершения будет помещена в очередь в CQ после завершения рабочего запроса.
STATUS_CONNECTION_INVALID	QP не подключен.
Другие коды состояния	Произошла ошибка.

Замечания

NdkInvalidate делает NDK быстро зарегистрированным MR или MW.

Требования

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