Funzione NdisMConfigMSIXTableEntry (ndis.h)
La funzione NdisMConfigMSIXTableEntry esegue operazioni di configurazione per MSI-X voci di tabella per i messaggi di MSI-X assegnati dal dispositivo.
Sintassi
NDIS_STATUS NdisMConfigMSIXTableEntry(
[in] NDIS_HANDLE NdisMiniportHandle,
[in] PNDIS_MSIX_CONFIG_PARAMETERS MSIXConfigParameters
);
Parametri
[in] NdisMiniportHandle
Handle di adattatore miniport NDIS fornito all'oggetto 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 MSI-X tabella è stata riconfigurata correttamente. |
|
NdisMConfigMSIXTableEntry non riuscito perché uno o più membri nel NDIS_MSIX_CONFIG_PARAMETERS struttura non è valida. |
Osservazioni
Driver miniport NDIS che supportano MSI-X chiamare la funzione NdisMConfigMSIXTableEntry per mascherare, annullare il mascheramento o mappare le voci di tabella MSI-X ai messaggi di MSI-X assegnati dal 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 venga restituito dalla funzione MiniportHaltEx.
Il driver miniport può impostare l'affinità CPU delle risorse di MSI-X interrupt in modo che il dispositivo abbia almeno un messaggio MSI-X per ogni processore RSS. Si noti che inizialmente il driver del bus PCI esegue il mapping delle voci di tabella n MSI-X (dove n è il numero di voci di tabella MSI-X segnalate dal NIC al bus) al primo n MSI-X messaggi nelle risorse modificate. Dopo che NDIS chiama MiniportInitializeEx, quando il driver miniport modifica il processore di destinazione di una determinata voce di tabella MSI-X, il driver chiama NdisMConfigMSIXTableEntry per eseguire il mapping di tale voce di tabella a un messaggio MSI-X che dispone già dell'affinità impostata sul processore desiderato.
Per l'operazione di NdisMSIXTableConfigSetTableEntry, i chiamanti di NdisMConfigMSIXTableEntry devono essere eseguiti in irQL <= DISPATCH_LEVEL.
Per il NdisMSIXTableConfigMaskTableEntry o NdisMSIXTableConfigUnmaskTableEntry operazioni, i chiamanti di NdisMConfigMSIXTableEntry possono essere eseguiti in qualsiasi IRQL.
Fabbisogno
| 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 |