Macro NdisMResetComplete (NDIS 6.x)

  • Articolo

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(
  NDIS_HANDLE MiniportAdapterHandle,
  NDIS_STATUS Status,
  BOOLEAN     AddressingReset
);

Parametri

MiniportAdapterHandle

Handle dell'adattatore miniport passato originariamente alla funzione MiniportInitializeEx .

Status

Stato finale dell'operazione di reimpostazione appena completata. I valori restituiti sono uguali a quelli elencati per la funzione di callback MINIPORT_RESET.

AddressingReset

Valore booleano true se NDIS è responsabile del ripristino delle impostazioni per indirizzi multicast, filtri pacchetti e informazioni di offload delle attività. In questo caso, il driver miniport è responsabile del ripristino delle altre impostazioni di configurazione per la scheda di interfaccia di rete (NIC) 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 tutti gli indirizzi multicast, il filtro dei pacchetti o le informazioni sull'indirizzo funzionale quando viene emesso un ripristino temporanea. Il driver di un'interfaccia di rete di questo tipo imposta AddressingReset su TRUE quando chiama NdisMResetComplete, causando la chiamata della funzione NDIS alla funzione MiniportOidRequest per ripristinare lo stato di indirizzamento. Per altre informazioni, vedere Reimpostazione hardware.

Un driver miniport deve rilasciare qualsiasi blocco di spin che sta tenendo 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 Windows Vista e versioni successive
Intestazione ndis.h
IRQL <= DISPATCH_LEVEL
Regole di conformità DDI Irql_Miniport_Driver_Function(ndis)

Vedi anche

Macro NdisMResetComplete (NDIS 5.x)