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