Функция 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 назначенными устройством. Драйверы минипорта, поддерживающие RSS, используют NdisMConfigMSIXTableEntry для изменения соответствия ЦП записей таблиц MSI-X во время выполнения.
NdisMConfigMSIXTableEntry — это оболочка вокруг запрос GUID_MSIX_TABLE_CONFIG_INTERFACE. Драйверы минипорта могут вызывать NdisMConfigMSIXTableEntry после вызова функции MiniportInitializeEx и до возвращения драйвера из функции MiniportHaltEx.
Минипорт-драйвер может задать сходство ЦП MSI-X ресурсов прерывания, чтобы устройство было по крайней мере одно MSI-X сообщение для каждого процессора RSS. Обратите внимание, что драйвер шины PCI изначально сопоставляет записи таблицы n MSI-X (где n является числом записей таблицы MSI-X, которые сетевой адаптер сообщил шине) с первым n MSI-X сообщений в измененных ресурсах. После вызова NDIS MiniportInitializeEx, когда драйвер минипорта изменяет целевой процессор определенной записи таблицы MSI-X, драйвер вызывает NdisMConfigMSConfigMSTableEntry сопоставить эту запись таблицы с сообщением MSI-X, которое уже имеет сопоставление с нужным процессором.
Для операции NdisMSMSIXTableConfigSetTableEntry вызывающие объекты NdisMConfigMSConfigMSIXTableEntry должны выполняться в IRQL <= DISPATCH_LEVEL.
Для операций NdisMSIXTableConfigMaskTableEntry или операций NdisMSIXTableConfigUnmaskTableEntry вызовы NdisMConfigMSIXTableEntry могут выполняться в любом IRQL.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Поддерживается в NDIS 6.1 и более поздних версиях. |
| целевая платформа | Всеобщий |
| заголовка | ndis.h (include Ndis.h) |
| библиотеки | Ndis.lib |
| IRQL | См. раздел "Примечания" |