Condividi tramite

Funzione NdisCloseAdapter (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.

NdisCloseAdapter rilascia l'associazione stabilita e le risorse allocate quando il protocollo denominato NdisOpenAdapter.

Sintassi

void NdisCloseAdapter(
  [out] PNDIS_STATUS Status,
  [in]  NDIS_HANDLE  NdisBindingHandle
);

Parametri

[out] Status

Puntatore a una variabile fornita dal chiamante in cui questa funzione restituisce lo stato dell'operazione di chiusura, che può essere uno dei valori seguenti:

  • NDIS_STATUS_SUCCESS
    L'associazione è stata chiusa e tutte le risorse relative a tale associazione sono state rilasciate.

  • NDIS_STATUS_PENDING
    Una richiesta close-adapter viene gestita in modo asincrono e la funzione ProtocolCloseAdapterComplete del chiamante verrà chiamata al termine dell'operazione di chiusura.

[in] NdisBindingHandle

Specifica l'handle restituito da NdisOpenAdapter che identifica l'adattatore virtuale o la scheda di interfaccia di rete da chiudere.

Valore restituito

nessuno

Osservazioni

Valore restituito: Nessuno

Un driver di protocollo chiama in genere NdisCloseAdapter dalla relativa funzione ProtocolUnbindAdapter . Può anche chiamare NdisCloseAdapter dalla funzione ProtocolBindAdapter , ad esempio se non è riuscito a impostare un valore OID dopo aver chiamato NdisOpenAdapter per configurare un'associazione.

Non appena un protocollo chiama NdisCloseAdapter, l'handle in NdisBindingHandle deve essere considerato non valido dal chiamante. Si tratta di un errore di programmazione per passare questo handle in qualsiasi chiamata successiva a una funzione NdisXxx .

  • Piattaforma di destinazione: universale
  • Versione: non supportata per i driver NDIS 6.0 in Windows Vista. Usare invece NdisCloseAdapterEx. 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