Funzione NdisCloseAdapterEx (ndis.h)

  • Articolo

Un driver di protocollo chiama la funzione NdisCloseAdapterEx per rilasciare l'associazione e le risorse allocate quando il driver ha chiamato la funzione NdisOpenAdapterEx .

Sintassi

NDIS_STATUS NdisCloseAdapterEx(
  [in] NDIS_HANDLE NdisBindingHandle
);

Parametri

[in] NdisBindingHandle

Handle fornito da NDIS nel parametro NdisBindingHandle di NdisOpenAdapterEx. Questo handle identifica l'associazione che NDIS deve chiudere.

Valore restituito

NdisCloseAdapterEx restituisce uno dei valori di stato seguenti:

Codice restituito Descrizione
NDIS_STATUS_SUCCESS
 NdisCloseAdapterEx ha chiuso correttamente l'associazione all'adattatore miniport sottostante.
NDIS_STATUS_PENDING
 NdisCloseAdapterEx non ha completato l'operazione di chiusura e l'operazione verrà completata in modo asincrono. NDIS chiama il driver del protocollo Funzione ProtocolCloseAdapterCompleteEx al termine dell'operazione.

Commenti

Un driver di protocollo chiama in genere NdisCloseAdapterEx dal relativo Funzione ProtocolUnbindAdapterEx . Il driver può anche chiamare NdisCloseAdapterEx dalla relativa funzione ProtocolBindAdapterEx . Ad esempio, se il driver non è riuscito a impostare un valore OID dopo che ha chiamato NdisOpenAdapterEx, può chiamare NdisCloseAdapterEx dalla relativa funzione ProtocolBindAdapterEx .

Se un driver di protocollo deve chiudere una scheda miniport al di fuori del contesto di ProtocolUnbindAdapterEx o ProtocolBindAdapterEx, deve chiamare la funzione NdisUnbindAdapter.

I driver di protocollo devono attendere che tutte le richieste e le richieste OID inviate vengano completate prima di chiamare NdisCloseAdapterEx.

Non appena il driver chiama NdisCloseAdapterEx, l'handle ottenuto dalla funzione NdisOpenAdapterEx nel parametro NdisBindingHandle diventa non valido.

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_Protocol_Driver_Function(ndis)

Vedi anche

NdisOpenAdapterEx

NdisUnbindAdapter

ProtocolBindAdapterEx

ProtocolCloseAdapterCompleteEx

ProtocolUnbindAdapterEx