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 |
|---|---|
|
La voce della tabella MSI-X è stata riconfigurata correttamente. |
|
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 |