共用方式為


NdisCmOpenAddressFamilyComplete 函式 (ndis.h)

NdisCmOpenAddressFamilyComplete 傳回呼叫管理員在呼叫管理員傳回NDIS_STATUS_PENDING響應該用戶端原始 open-AF 要求之後,針對特定客戶端開啟指定 AF 的最終狀態。

語法

void NdisCmOpenAddressFamilyComplete(
  [in] NDIS_STATUS Status,
  [in] NDIS_HANDLE NdisAfHandle,
  [in] NDIS_HANDLE CallMgrAfContext
);

參數

[in] Status

指定 open-AF 作業的最終狀態,NDIS_STATUS_SUCCESS或任何 CM 決定的錯誤NDIS_STATUS_ XXX,但NDIS_STATUS_PENDING除外。

[in] NdisAfHandle

指定輸入呼叫管理員之 通訊協定CmOpenAf 函式的 NDIS 提供的句柄,該函式會傳回NDIS_STATUS_PENDING。

[in] CallMgrAfContext

指定呼叫端配置的駐地內容區域的句柄,如果開啟成功,呼叫管理員會維護此客戶端開啟位址系列的狀態,包括 NdisAfHandle。 如果 狀態 未NDIS_STATUS_SUCCESS,NDIS 會忽略此參數。

傳回值

沒有

言論

獨立呼叫管理員必須呼叫 NdisCmOpenAddressFamilyComplete,如果 先前針對指定的 NdisAfHandle 傳回NDIS_STATUS_PENDING ProtocolCmOpenAf 函式。 用戶端以呼叫 NdisClOpenAddressFamilyEx來起始 pended open-AF 作業,在 NdisCmOpenAddressFamilyComplete 導致該用戶端呼叫該用戶端之前,無法對相同的系結執行進一步的聯機導向作業 ProtocolClOpenAfCompleteEx 函式。

如果 NdisCmOpenAddressFamilyComplete 的呼叫者 將狀態 設定為 NDIS_STATUS_SUCCESS, NDIS 接著會將指定的 CallMgrAfContext 句柄當做輸入參數傳遞至所有 CM 提供的 ProtocolCmXxx 和 ProtocolCoXxx 函式,這些函式會涉及用戶端開啟位址系列,直到用戶端關閉 AF 為止。 呼叫管理員應該釋放或重複使用它配置的任何 AF 內容區域,再將失敗狀態傳遞給 NdisCmOpenAddressFamilyComplete

為了成功開啟,NDIS 提供的 NdisAfHandle 代表呼叫管理員與用戶端在呼叫管理員和用戶端系結的特定迷你埠驅動程式上開啟 AF 之間的關聯。 在後續呼叫 NdisCl/Cm/CoXxx 函式時,這兩個通訊協定驅動程式都必須將 NdisAfHandle 視為傳遞、未修改和未解譯的不透明變數。 若開啟失敗,當 NdisMCmOpenAddressFamilyComplete 傳回控件時,呼叫管理員應考慮 NdisAfHandle 無效。

只有向 NDIS 註冊為通訊協定驅動程式的獨立呼叫管理員,才能呼叫 NdisCmOpenAddressFamilyComplete。 提供整合式通話管理支持的連線導向迷你埠驅動程序必須呼叫 NdisMCmOpenAddressFamilyComplete

要求

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

另請參閱

NdisAllocateFromNPagedLookasideList

NdisClOpenAddressFamilyEx

NdisMCmOpenAddressFamilyComplete

ProtocolClOpenAfCompleteEx

ProtocolCmOpenAf