Funzione NdisFRestartComplete (ndis.h)

Articolo
02/29/2024

Un driver di filtro deve chiamare la funzione NdisFRestartComplete per completare un'operazione di riavvio se il driver ha restituito NDIS_STATUS_PENDING dalla relativa funzione FilterRestart .

Sintassi

void NdisFRestartComplete(
  [in] NDIS_HANDLE NdisFilterHandle,
  [in] NDIS_STATUS Status
);

Parametri

[in] NdisFilterHandle

Handle NDIS che identifica questo modulo di filtro. NDIS ha passato l'handle al driver di filtro in una chiamata alla funzione FilterAttach .

[in] Status

Stato finale dell'operazione di riavvio. Sono supportati i valori di stato seguenti:

NDIS_STATUS_SUCCESS

Il driver ha riavviato correttamente il flusso di dati di rete.

NDIS_STATUS_RESOURCES

Il riavvio non è riuscito a causa di risorse insufficienti.

NDIS_STATUS_FAILURE

Il driver indica NDIS_STATUS_FAILURE se nessuno dei valori precedenti si applica. Il driver deve chiamare la funzione NdisWriteEventLogEntry insieme ai parametri che specificano il motivo dell'errore.

Valore restituito

nessuno

Osservazioni

NDIS chiama la funzione FilterRestart di un driver di filtro per avviare una richiesta di riavvio per il modulo di filtro. Il modulo di filtro rimane nello stato di riavvio fino al completamento dell'operazione di riavvio.

Un'operazione di riavvio in sospeso viene completata dopo che il driver chiama la funzione NdisFRestartComplete . Il modulo filtro si trova nello stato In esecuzione dopo il completamento dell'operazione di riavvio.

Un driver di filtro può riprendere a indicare i dati di rete ricevuti immediatamente dopo le chiamate NDIS FilterRestart e prima che il driver chiami NdisFRestartComplete. Il driver deve essere pronto per accettare richieste di invio dopo aver completato l'operazione di riavvio.

Requisiti

Requisito	Valore
Client minimo supportato	Supportato in NDIS 6.0 e versioni successive.
Piattaforma di destinazione	Desktop
Intestazione	ndis.h (includere Ndis.h)
Libreria	Ndis.lib
IRQL	PASSIVE_LEVEL
Regole di conformità DDI	Irql_Filter_Driver_Function(ndis)