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 |
|---|---|
|
A operação foi concluída com sucesso. |
|
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 |