PCI_MSIX_SET_ENTRY função de retorno de chamada (wdm.h)

A rotina SetTableEntry define a ID da mensagem para uma entrada de tabela na tabela de interrupção de hardware MSI-X.

Sintaxe

PCI_MSIX_SET_ENTRY PciMsixSetEntry;

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

Parâmetros

[in] Context

Um ponteiro para informações de contexto específicas da interface. O chamador passa o valor que é passado como o membro Context da estrutura PCI_MSIX_TABLE_CONFIG_INTERFACE para a interface.

[in] TableEntry

O índice da entrada da tabela na tabela de interrupção de hardware MSI-X.

[in] MessageNumber

A ID da mensagem para a interrupção. Esse valor também é o índice para a entrada da interrupção no membro MessageInfo da estrutura IO_INTERRUPT_MESSAGE_INFO que descreve as interrupções sinalizadas por mensagem do driver. A função IoConnectInterruptEx fornece um ponteiro para essa estrutura.

Retornar valor

A rotina SetTableEntry pode retornar um dos seguintes valores NTSTATUS:

Código de retorno	Descrição
STATUS_SUCCESS	A operação foi concluída com sucesso.
STATUS_INVALID_PARAMETER	O dispositivo não usa MSI-X ou os parâmetros TableEntry ou MessageNumber não correspondem a recursos de interrupção atribuídos ao dispositivo.

Comentários

Por padrão, o sistema operacional atribui o índice da entrada da tabela como a ID da mensagem para a interrupção. Se houver mais entradas de tabela do que mensagens, o sistema definirá as entradas restantes da tabela como correspondentes à mensagem zero. O driver pode usar a rotina SetTableEntry para atribuir uma ID de mensagem diferente.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows Vista com Service Pack 1 (SP1), Windows Server 2008 e versões posteriores do sistema operacional Windows.
Plataforma de Destino	Área de Trabalho
Cabeçalho	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
IRQL	<= DIRQL

Confira também

IO_INTERRUPT_MESSAGE_INFO

IoConnectInterruptEx

PCI_MSIX_TABLE_CONFIG_INTERFACE