Macro NdisMResetComplete (ndis.h)
Nota
Per NDIS 6.x (Windows Vista e versioni successive), usare invece la funzione NdisMResetComplete (NDIS 6.x).
La funzione NdisMResetComplete restituisce lo stato finale di una richiesta di reimpostazione per cui il driver miniport restituito in precedenza NDIS_STATUS_PENDING.
Sintassi
void NdisMResetComplete(
_M,
_S,
_A
);
Parametri
_M
Handle dell'adattatore miniport passato originariamente alla funzione MiniportInitializeEx .
_S
Stato finale dell'operazione di reimpostazione appena completata. I valori restituiti corrispondono a quelli elencati per la funzione di callback MINIPORT_RESET.
_A
Valore booleano true se NDIS è responsabile del ripristino delle impostazioni per indirizzi multicast, filtri di pacchetti e informazioni sull'offload delle attività. In questo caso, il driver miniport è responsabile del ripristino delle altre impostazioni di configurazione per la scheda di interfaccia di rete a cui fa riferimento MiniportAdapterHandle .
Se AddressingReset è FALSE, il driver miniport è responsabile del ripristino di tutte le impostazioni di configurazione per la scheda di interfaccia di rete.
Per altre informazioni, vedere Reimpostazione hardware.
Valore restituito
nessuno
Osservazioni
Se la funzione MiniportResetEx restituisce NDIS_STATUS_PENDING, il driver miniport deve chiamare NdisMResetComplete al termine dell'operazione di reimpostazione.
I driver di protocollo non possono avviare un'operazione di reimpostazione in NDIS 6.0 e versioni successive.
Alcune schede di interfaccia di rete perdono tutte le informazioni relative all'indirizzo multicast, al filtro dei pacchetti o all'indirizzo funzionale quando viene eseguita una reimpostazione temporanea. Il driver di tale scheda di interfaccia di rete imposta AddressingReset su TRUE quando chiama NdisMResetComplete, causando la chiamata di NDIS alla funzione MiniportOidRequest per ripristinare lo stato di indirizzamento. Per altre informazioni, vedere Reimpostazione hardware.
Un driver miniport deve rilasciare qualsiasi blocco di rotazione che mantiene prima di chiamare NdisMResetComplete.
In NDIS 6.0 e versioni successive, i chiamanti di NdisMResetComplete devono essere eseguiti in IRQL <= DISPATCH_LEVEL. In caso contrario, i chiamanti di NdisMResetComplete devono essere eseguiti in IRQL = DISPATCH_LEVEL.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Supportato in NDIS 5.1 e NDIS 6.0 e versioni successive. Per i driver NDIS 5.1, vedere NdisMResetComplete (NDIS 5.1). |
| Piattaforma di destinazione | Universale |
| Intestazione | ndis.h (include Ndis.h) |
| Libreria | Ndis.lib |
| IRQL | DISPATCH_LEVEL |
| Regole di conformità DDI | Irql_Miniport_Driver_Function(ndis) |