共用方式為


NdisMCmOpenAddressFamilyComplete 巨集 (ndis.h)

NdisMCmOpenAddressFamilyComplete 會傳回用戶端要求的最終狀態,其中 MCM 驅動程式的 ProtocolCmOpenAf 函式會傳回NDIS_STATUS_PENDING,以開啟 MCM 驅動程式的位址系列。

語法

void NdisMCmOpenAddressFamilyComplete(
   _S_,
   _H_,
   _C_
);

參數

_S_

指定用戶端要求開啟 AF 的最終狀態,NDIS_STATUS_SUCCESS或任何呼叫端決定的 NDIS_STATUS_ XXX,但 NDIS_STATUS_PENDING 除外。

_H_

指定輸入至 MCM 驅動程式 ProtocolCmOpenAf 函式的 NDIS 提供的句柄,此函式會傳回NDIS_STATUS_PENDING。

_C_

指定呼叫端配置的駐地內容區域的句柄,如果開啟成功,MCM 驅動程式會維護此客戶端開啟位址家族的狀態,包括 NdisAfHandle。 否則,NDIS 會忽略此參數。

傳回值

沒有

言論

MCM 驅動程式必須呼叫 NdisMCmOpenAddressFamilyComplete,如果 先前針對指定的 NdisAfHandle 傳回NDIS_STATUS_PENDING的 ProtocolCmOpenAf 函式。 用戶端以呼叫 NdisClOpenAddressFamilyEx起始 pended open-AF 作業,在 NdisMCmOpenAddressFamilyComplete 導致對該用戶端的呼叫之前,無法在相同系結上執行進一步的連線導向作業 ProtocolClOpenAfCompleteEx 函式。

如果 NdisMCmOpenAddressFamilyComplete 的呼叫端 會將狀態 設定為 NDIS_STATUS_SUCCESS, NDIS 接著會將指定的 CallMgrAfContext 句柄當做輸入參數傳遞給所有 MCM 驅動程式提供的 ProtocolCmXxx 和 ProtocolCoXxx 函式,讓用戶端關閉 AF 為止。 MCM 驅動程式應該釋放或重複使用它配置的任何 AF 內容區域,再將失敗狀態傳遞給 NdisMCmOpenAddressFamilyComplete

若要成功開啟,NDIS 提供的 NdisAfHandle 代表已開啟 AF 的 MCM 驅動程式與用戶端之間的關聯。 在後續呼叫 NdisCl/Co/MCm/MCoXxx 函式時,這兩個 NDIS 驅動程式都必須將 NdisAfHandle 視為傳遞、未修改和未解譯的不透明變數。 若開啟失敗,當 NdisMCmOpenAddressFamilyComplete 傳回控件時,MCM 驅動程式應考慮 NdisAfHandle 無效。

只有提供整合式呼叫管理支援的連線導向迷你埠驅動程式可以呼叫 NdisMCmOpenAddressFamilyComplete。 以 NDIS 註冊為通訊協定驅動程式的獨立呼叫管理員,請改為呼叫 NdisCmOpenAddressFamilyComplete

要求

要求 價值
最低支援的用戶端 支援 NDIS 6.0 和 NDIS 5.1 驅動程式(請參閱 Windows Vista 中的 NdisMCmOpenAddressFamilyComplete (NDIS 5.1)。 支援 NDIS 5.1 驅動程式(請參閱 Windows XP 中的 NdisMCmOpenAddressFamilyComplete (NDIS 5.1)。
目標平臺 桌面
標頭 ndis.h (包括 Ndis.h)
IRQL <= DISPATCH_LEVEL
DDI 合規性規則 Irql_MCM_Function(ndis)

另請參閱

NdisAllocateFromNPagedLookasideList

NdisClOpenAddressFamilyEx

NdisCmOpenAddressFamilyComplete

ProtocolClOpenAfCompleteEx

ProtocolCmOpenAf