Функция 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 или одно из следующих значений состояния:
| Код возврата | Описание |
|---|---|
|
Запись таблицы MSI-X была успешно перенастроена. |
|
Сбой 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 | См. раздел "Примечания" |