NdisCloseAdapterEx 函式 (ndis.h)
通訊協定驅動程式會呼叫 NdisCloseAdapterEx 函式,以釋放驅動程式呼叫 NdisOpenAdapterEx 函式時所配置的系結和資源。
語法
NDIS_STATUS NdisCloseAdapterEx(
[in] NDIS_HANDLE NdisBindingHandle
);
參數
[in] NdisBindingHandle
NdisOpenAdapterEx之 NdisBindingHandle 參數所提供的 NDIS 句柄。 此句柄會識別 NDIS 應該關閉的系結。
傳回值
NdisCloseAdapterEx 會傳回下列其中一個狀態值:
傳回碼 | 描述 |
---|---|
|
NdisCloseAdapterEx 成功關閉基礎迷你埠配接器的系結。 |
|
NdisCloseAdapterEx 未完成關閉作業,且作業將會以異步方式完成。 NDIS 會呼叫通訊協定驅動程式的當作業完成時, ProtocolCloseAdapterCompleteEx 函式。 |
言論
通訊協定驅動程式通常會從其呼叫 NdisCloseAdapterEx ProtocolUnbindAdapterEx 函式。 驅動程式也可以從其 ProtocolBindAdapterEx 函式呼叫 NdisCloseAdapterEx。 例如,如果驅動程式在呼叫 NdisOpenAdapterEx之後無法設定 OID 值,則可以從其 ProtocolBindAdapterEx 函式呼叫 NdisCloseAdapterEx。
如果通訊協定驅動程式必須關閉 ProtocolUnbindAdapterEx 或 ProtocolBindAdapterEx的迷你埠配接器,則必須呼叫 NdisUnbindAdapter 函式。
通訊協定驅動程式應該先等候所有傳送要求和 OID 要求,再呼叫 NdisCloseAdapterEx。
驅動程式呼叫 NdisCloseAdapterEx時,從 NdisOpenAdapterEx 函式取得的句柄 NdisBindingHandle 參數會變成無效。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | NDIS 6.0 和更新版本支援。 |
目標平臺 | 桌面 |
標頭 | ndis.h (包括 Ndis.h) |
連結庫 | Ndis.lib |
IRQL | PASSIVE_LEVEL |
DDI 合規性規則 | Irql_Protocol_Driver_Function(ndis) |