NdisCmNotifyCloseAddressFamily 函式 (ndis.h)

發行項
02/26/2024

NdisCmNotifyCloseAddressFamily 函式會通知 NDIS 呼叫管理員從基礎迷你埠配接器解除系結，而且任何相關聯的 CoNDIS 用戶端都應該關閉指定的位址系列 (AF) 。

語法

NDIS_STATUS NdisCmNotifyCloseAddressFamily(
  [in] NDIS_HANDLE NdisAfHandle
);

參數

[in] NdisAfHandle

識別 NDIS 應該關閉的 AF 的 NDIS 句柄。 NDIS 提供此句柄給呼叫管理員的 ProtocolCmOpenAf 函式。

傳回值

NdisCmNotifyCloseAddressFamily 可以傳回下列其中一項：

傳回碼	Description
NDIS_STATUS_SUCCESS	NDIS 已成功關閉位址系列。
NDIS_STATUS_PENDING	NDIS 會以異步方式處理此要求，它會呼叫呼叫管理員的 ProtocolCmNotifyCloseAfComplete 函式完成關閉作業時。
NDIS_STATUS_XXX	NDIS 因某些 NDIS 或用戶端驅動程式決定的原因而失敗要求。

備註

獨立 CoNDIS 呼叫管理員，其會藉由呼叫來註冊為 NDIS 通訊協定驅動程式 NdisRegisterProtocolDriver 函式可以呼叫 NdisCmNotifyCloseAddressFamily 函式 。迷你埠通話管理員會改為呼叫 (MC) NdisMCmNotifyCloseAddressFamily 函式。

若要關閉系結的 AF，獨立呼叫管理員應該從呼叫 NdisCmNotifyCloseAddressFamily ProtocolUnbindAdapterEx 函式。接著，NDIS 會呼叫已開啟指定 AF 之用戶端的 ProtocolClNotifyCloseAf 函式。

如果 NdisCmNotifyCloseAddressFamily 傳回NDIS_STATUS_PENDING，NDIS 會呼叫呼叫管理員的 ProtocolCmNotifyCloseAfComplete 函式在用戶端完成 AF 關閉作業之後。

規格需求

需求	值
最低支援的用戶端	NDIS 6.0 和更新版本支援。
目標平台	桌面
標頭	ndis.h (包括 Ndis.h)
程式庫	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI 合規性規則	Irql_CallManager_Function (ndis)