Поделиться через


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

Подпрограмма SetTableEntry задает идентификатор сообщения для записи таблицы в таблице аппаратных прерываний MSI-X.

Синтаксис

PCI_MSIX_SET_ENTRY PciMsixSetEntry;

NTSTATUS PciMsixSetEntry(
  [in] PVOID Context,
  [in] ULONG TableEntry,
  [in] ULONG MessageNumber
)
{...}

Параметры

[in] Context

Указатель на сведения о контексте для конкретного интерфейса. Вызывающий объект передает значение, переданное в качестве элемента Contextструктуры PCI_MSIX_TABLE_CONFIG_INTERFACE для интерфейса.

[in] TableEntry

Индекс записи таблицы в таблице аппаратных прерываний MSI-X.

[in] MessageNumber

Идентификатор сообщения для прерывания. Это значение также является индексом для записи прерывания в элементе MessageInfoструктуры IO_INTERRUPT_MESSAGE_INFO , описывающей прерывания, сигнализированные драйвером о сообщениях. Функция IoConnectInterruptEx предоставляет указатель на эту структуру.

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

Подпрограмма SetTableEntry может возвращать одно из следующих значений NTSTATUS:

Код возврата Описание
STATUS_SUCCESS
Операция выполнена успешно.
STATUS_INVALID_PARAMETER
Устройство не использует MSI-X, либо параметры TableEntry или MessageNumber не соответствуют ресурсам прерывания, назначенным устройству.

Комментарии

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

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows Vista с пакетом обновления 1 (SP1), Windows Server 2008 и более поздних версиях операционной системы Windows.
Целевая платформа Персональный компьютер
Верхняя часть wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)
IRQL <= DIRQL

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

IO_INTERRUPT_MESSAGE_INFO

IoConnectInterruptEx

PCI_MSIX_TABLE_CONFIG_INTERFACE