Funzione NdisCloseAdapterEx (ndis.h)
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 |
|---|---|
|
NdisCloseAdapterEx ha chiuso correttamente l'associazione all'adattatore miniport sottostante. |
|
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) |