Funzione NdisMConfigMSIXTableEntry (ndis.h)

La funzione NdisMConfigMSIXTableEntry esegue operazioni di configurazione per le voci di tabella MSI-X per i messaggi MSI-X assegnati al dispositivo.

Sintassi

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

Parametri

[in] NdisMiniportHandle

Handle dell'adattatore miniport NDIS fornito dall'NDIS Funzione MiniportInitializeEx .

[in] MSIXConfigParameters

Puntatore a un chiamante allocato NDIS_MSIX_CONFIG_PARAMETERS struttura che definisce l'operazione di configurazione richiesta e specifica i parametri necessari per tale operazione specifica.

Valore restituito

NdisMConfigMSIXTableEntry restituisce un codice di errore appropriato dal driver del bus PCI sottostante o uno dei valori di stato seguenti:

Codice restituito	Descrizione
NDIS_STATUS_SUCCESS	La voce della tabella MSI-X è stata riconfigurata correttamente.
NDIS_STATUS_INVALID_PARAMETER	NdisMConfigMSIXTableEntry non riuscito perché uno o più membri nel NDIS_MSIX_CONFIG_PARAMETERS struttura non è valida.

Commenti

I driver miniport NDIS che supportano MSI-X chiamano la funzione NdisMConfigMSIXTableEntry per mascherare, annullare il mascheramento o eseguire il mapping delle voci di tabella MSI-X ai messaggi MSI-X assegnati al dispositivo. I driver Miniport che supportano RSS usano NdisMConfigMSIXTableEntry per modificare l'affinità CPU delle voci di tabella MSI-X in fase di esecuzione.

NdisMConfigMSIXTableEntry è un wrapper intorno a GUID_MSIX_TABLE_CONFIG_INTERFACE query. I driver Miniport possono chiamare NdisMConfigMSIXTableEntry dopo che NDIS chiama la funzione MiniportInitializeEx e prima che il driver torni dalla funzione MiniportHaltEx .

Il driver miniport può impostare l'affinità CPU delle risorse di interrupt MSI-X in modo che il dispositivo abbia almeno un messaggio MSI-X per ogni processore RSS. Si noti che il driver del bus PCI esegue inizialmente il mapping delle n voci di tabella MSI-X (dove n è il numero di voci di tabella MSI-X segnalate dall'interfaccia di rete al bus) ai primi n messaggi MSI-X nelle risorse modificate. Dopo che NDIS chiama MiniportInitializeEx, quando il driver miniport modifica il processore di destinazione di una particolare voce di tabella MSI-X, il driver chiama NdisMConfigMSIXTableEntry per eseguire il mapping di tale voce di tabella a un messaggio MSI-X che ha già impostato l'affinità sul processore desiderato.

Per l'operazione NdisMSIXTableConfigSetTableEntry , i chiamanti di NdisMConfigMSIXTableEntry devono essere eseguiti in IRQL <= DISPATCH_LEVEL.

Per le operazioni NdisMSIXTableConfigMaskTableEntry o NdisMSIXTableConfigUnmaskTableEntry , i chiamanti di NdisMConfigMSIXTableEntry possono essere eseguiti in qualsiasi IRQL.

Requisiti

Requisito	Valore
Client minimo supportato	Supportato in NDIS 6.1 e versioni successive.
Piattaforma di destinazione	Universale
Intestazione	ndis.h (include Ndis.h)
Libreria	Ndis.lib
IRQL	Vedere la sezione Osservazioni

Vedi anche

MiniportHaltEx

MiniportInitializeEx

NDIS_MSIX_CONFIG_PARAMETERS