Funzione NdisDeregisterProtocol (ndis.h)

  • Articolo

Nota NDIS 5. x è stato deprecato ed è sostituito da NDIS 6. x. Per il nuovo sviluppo di driver NDIS, vedere Driver di rete a partire da Windows Vista. Per informazioni sulla conversione di NDIS 5. driver x a NDIS 6. x, vedere Conversione di driver NDIS 5.x in NDIS 6.0.

NdisDeregisterProtocol rilascia le risorse allocate quando il driver denominato NdisRegisterProtocol.

Sintassi

void NdisDeregisterProtocol(
  [out] PNDIS_STATUS Status,
  [in]  NDIS_HANDLE  NdisProtocolHandle
);

Parametri

[out] Status

Puntatore a una variabile fornita dal chiamante impostata su NDIS_STATUS_SUCCESS restituita da questa funzione.

[in] NdisProtocolHandle

Specifica l'handle restituito da NdisRegisterProtocol quando il driver è stato inizializzato.

Valore restituito

nessuno

Osservazioni

I driver di protocollo registrati chiamano NdisDeregisterProtocol in una delle circostanze seguenti:

  • Il driver già chiamato NdisRegisterProtocol correttamente, ma non può essere associato a qualsiasi driver NDIS sottostante nel computer.

  • Il driver viene scaricato. Vale a dire, la routine Di caricamento configurata nel relativo oggetto driver durante l'inizializzazione è stata chiamata o la funzione ProtocolUnbindAdapter è stata chiamata per rilasciare l'ultima associazione rimanente del driver.

    Per altre informazioni sulla routine di scaricamento e su altre routine di driver in modalità kernel standard, vedere Componenti driver in modalità kernel.

  • Il sistema viene arrestato. Poiché il driver, che è un protocollo di livello più alto, denominato IoRegisterShutdownNotification quando è stato inizializzato, la routine di arresto è stata chiamata.

    Per altre informazioni, vedere IoRegisterShutdownNotification .

Se un protocollo ha associazioni aperte, la chiamata a NdisDeregisterProtocol causa la chiamata di NDIS alla funzione ProtocolUnbindAdapter del protocollo una sola volta per ogni associazione aperta. ProtocolUnbindAdapter chiama NdisCloseAdapter per chiudere l'associazione.

Quando si apre in sospeso, se presente, NdisDeregisterProtocol rilascia tutti i filtri che il chiamante ha configurato e libera l'NDIS di memoria allocata per tenere traccia delle associazioni e dei filtri per il driver del protocollo.

  • Piattaforma di destinazione: universale
  • Versione: non supportata per i driver NDIS 6.0 in Windows Vista. Usare invece NdisDeregisterProtocolDriver. Supportato per i driver NDIS 5.1 in Windows Vista e Windows XP.

Requisiti

Requisito Valore
Intestazione ndis.h (includere Ndis.h)
Libreria Ndis.lib
IRQL PASSIVE_LEVEL

Vedi anche