Macro NdisMResetComplete (ndis.h)

  • Articolo

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)

Vedi anche

MiniportInitializeEx

MiniportOidRequest

MiniportResetEx

Funzione NdisMResetComplete (NDIS 6.x)