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 |
|---|---|
|
A entrada da tabela MSI-X foi reconfigurada com êxito. |
|
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 |