Функция NdisMConfigMSIXTableEntry (ndis.h)

  • Статья

Функция NdisMConfigMSIXTableEntry выполняет операции настройки записей таблицы MSI-X для сообщений MSI-X, назначаемых устройством.

Синтаксис

NDIS_STATUS NdisMConfigMSIXTableEntry(
  [in] NDIS_HANDLE                  NdisMiniportHandle,
  [in] PNDIS_MSIX_CONFIG_PARAMETERS MSIXConfigParameters
);

Параметры

[in] NdisMiniportHandle

Обработчик адаптера мини-порта NDIS, который NDIS поставляется вФункция MiniportInitializeEx.

[in] MSIXConfigParameters

Указатель на выделенный вызывающим объект NDIS_MSIX_CONFIG_PARAMETERS структуру, которая определяет запрошенную операцию конфигурации и указывает параметры, необходимые для конкретной операции.

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

NdisMConfigMSIXTableEntry возвращает соответствующий код сбоя из базового драйвера шины PCI или одно из следующих значений состояния:

Код возврата Описание
NDIS_STATUS_SUCCESS
 Запись таблицы MSI-X была успешно перенастроена.
NDIS_STATUS_INVALID_PARAMETER
 Сбой NdisMConfigMSIXTableEntry , так как один или несколько членов в NDIS_MSIX_CONFIG_PARAMETERS структура была недопустимой.

Комментарии

Драйверы мини-портов NDIS, поддерживающие MSI-X, вызывают функцию NdisMConfigMSIXTableEntry , чтобы маскировать, размаскировать или сопоставить записи таблицы MSI-X с сообщениями MSI-X, назначаемыми устройством. Драйверы miniport, поддерживающие RSS, используют NdisMConfigMSIXTableEntry для изменения сходства ЦП записей таблицы MSI-X во время выполнения.

NdisMConfigMSIXTableEntry — это оболочка вокруг запрос GUID_MSIX_TABLE_CONFIG_INTERFACE . Драйверы miniport могут вызывать NdisMConfigMSIXTableEntry после вызова NDIS функции MiniportInitializeEx и до возврата драйвера из функции MiniportHaltEx .

Драйвер мини-порта может задать сходство ЦП для ресурсов прерываний MSI-X, чтобы устройство было по крайней мере одно сообщение MSI-X для каждого обработчика RSS. Обратите внимание, что драйвер шины PCI изначально сопоставляет n записей таблицы MSI-X (где n — это количество записей таблицы MSI-X, о которых сетевой адаптер сообщил шине) с первыми n сообщений MSI-X в измененных ресурсах. После того как NDIS вызывает MiniportInitializeEx, когда драйвер мини-порта изменяет целевой процессор определенной записи таблицы MSI-X, драйвер вызывает NdisMConfigMSIXTableEntry , чтобы сопоставить запись таблицы с сообщением MSI-X, которое уже имеет сходство с нужным процессором.

Для операции NdisMSIXTableConfigSetTableEntry вызывающие методы NdisMConfigMSIXTableEntry должны выполняться по адресу IRQL <= DISPATCH_LEVEL.

Для операций NdisMSIXTableConfigMaskTableEntry или NdisMSIXTableConfigUnmaskTableEntry вызовы NdisMConfigMSIXTableEntry могут выполняться в любом irQL.

Требования

Требование Значение
Минимальная версия клиента Поддерживается в NDIS 6.1 и более поздних версиях.
Целевая платформа Универсальное
Верхняя часть ndis.h (включая Ndis.h)
Библиотека Ndis.lib
IRQL См. раздел "Примечания"

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

MiniportHaltEx

MiniportInitializeEx

NDIS_MSIX_CONFIG_PARAMETERS