функция обратного вызова 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
Указатель на сведения о контексте для интерфейса. Вызывающий объект передает значение, передаваемое как элемент контекста контекста элемента структуры PCI_MSIX_TABLE_CONFIG_INTERFACE для интерфейса.
[in] TableEntry
Индекс записи таблицы в MSI-X аппаратной таблице прерываний.
[in] MessageNumber
Идентификатор сообщения для прерывания. Это значение также является индексом записи прерывания в элементе MessageInfo структуры IO_INTERRUPT_MESSAGE_INFO, описывающей прерывания, сигнализированные драйвером. Функция IoConnectInterruptEx предоставляет указатель на эту структуру.
Возвращаемое значение
Подпрограмма setTableEntry может возвращать одно из следующих значений NTSTATUS:
| Возвращаемый код | Описание |
|---|---|
|
Операция успешно завершена. |
|
Устройство не использует MSI-X или параметры TableEntry или MessageNumber не соответствуют ресурсам прерывания, назначенным устройству. |
Замечания
По умолчанию операционная система назначает индекс записи таблицы в качестве идентификатора сообщения для прерывания. Если есть больше записей таблицы, чем сообщения, система задает оставшиеся записи таблицы, чтобы соответствовать нулю сообщения. Драйвер может использовать подпрограмму setTableEntry setTableEntry для назначения другого идентификатора сообщения.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно в Windows Vista с пакетом обновления 1 (SP1), Windows Server 2008 и более поздними версиями операционной системы Windows. |
| целевая платформа | Настольный |
| заголовка | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| IRQL | <= DIRQL |