Compartilhar via


Função NdisMConfigMSIXTableEntry (ndis.h)

A função NdisMConfigMSIXTableEntry executa operações de configuração para entradas de tabela MSI-X para mensagens MSI-X atribuídas pelo dispositivo.

Sintaxe

NDIS_STATUS NdisMConfigMSIXTableEntry(
  [in] NDIS_HANDLE                  NdisMiniportHandle,
  [in] PNDIS_MSIX_CONFIG_PARAMETERS MSIXConfigParameters
);

Parâmetros

[in] NdisMiniportHandle

Um identificador de adaptador de miniporta NDIS fornecido para o NDIS Função MiniportInitializeEx .

[in] MSIXConfigParameters

Um ponteiro para um chamador alocado NDIS_MSIX_CONFIG_PARAMETERS estrutura que define a operação de configuração solicitada e especifica os parâmetros necessários para essa operação específica.

Retornar valor

NdisMConfigMSIXTableEntry retorna um código de falha apropriado do driver de barramento PCI subjacente ou um dos seguintes valores de status:

Código de retorno Descrição
NDIS_STATUS_SUCCESS
A entrada da tabela MSI-X foi reconfigurada com êxito.
NDIS_STATUS_INVALID_PARAMETER
NdisMConfigMSIXTableEntry falhou porque um ou mais membros no NDIS_MSIX_CONFIG_PARAMETERS estrutura eram inválidas.

Comentários

Drivers de miniporto NDIS que dão suporte a MSI-X chamam a função NdisMConfigMSIXTableEntry para mascarar, desmascarar ou mapear entradas de tabela MSI-X para mensagens MSI-X atribuídas pelo dispositivo. Os drivers de miniport que dão suporte ao RSS usam NdisMConfigMSIXTableEntry para alterar a afinidade de CPU das entradas da tabela MSI-X em tempo de execução.

NdisMConfigMSIXTableEntry é um wrapper em torno do GUID_MSIX_TABLE_CONFIG_INTERFACE consulta. Os drivers de miniport podem chamar NdisMConfigMSIXTableEntry depois que o NDIS chama a função MiniportInitializeEx e antes que o driver retorne da função MiniportHaltEx .

O driver de miniporta pode definir a afinidade de CPU dos recursos de interrupção do MSI-X para que o dispositivo tenha pelo menos uma mensagem MSI-X para cada processador RSS. Observe que o driver de barramento PCI mapeia inicialmente as entradas da tabela n MSI-X (em que n é o número de entradas de tabela MSI-X que o hadware NIC relatou ao barramento) para as primeiras n mensagens MSI-X em recursos modificados. Depois que o NDIS chama MiniportInitializeEx, quando o driver de miniporta altera o processador de destino de uma entrada de tabela MSI-X específica, o driver chama NdisMConfigMSIXTableEntry para mapear essa entrada de tabela para uma mensagem MSI-X que já tem a afinidade definida para o processador desejado.

Para a operação NdisMSIXTableConfigSetTableEntry , os chamadores de NdisMConfigMSIXTableEntry devem ser executados em IRQL <= DISPATCH_LEVEL.

Para as operações NdisMSIXTableConfigMaskTableEntry ou NdisMSIXTableConfigUnmaskTableEntry , os chamadores de NdisMConfigMSIXTableEntry podem estar em execução em qualquer IRQL.

Requisitos

Requisito Valor
Cliente mínimo com suporte Com suporte no NDIS 6.1 e posterior.
Plataforma de Destino Universal
Cabeçalho ndis.h (inclua Ndis.h)
Biblioteca Ndis.lib
IRQL Consulte a seção Comentários

Confira também

MiniportHaltEx

MiniportInitializeEx

NDIS_MSIX_CONFIG_PARAMETERS