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
指定輸入呼叫管理員 ProtocolCmOpenAf 函式的 NDIS 提供的句柄，該函式會傳回NDIS_STATUS_PENDING。
[in] CallMgrAfContext
指定呼叫端配置的駐留內容區域的句柄，當開啟成功時，呼叫管理員會維護此客戶端開啟位址系列的狀態，包括 NdisAfHandle。 如果未NDIS_STATUS_SUCCESS Status，NDIS 會忽略此參數。
傳回值
無
備註
獨立呼叫管理員必須呼叫 NdisCmOpenAddressFamilyComplete ，如果其 ProtocolCmOpenAf 函式先前針對指定的 NdisAfHandle 傳回NDIS_STATUS_PENDING。 起始手寫式 open-AF 作業且呼叫 NdisClOpenAddressFamilyEx 的客戶端無法在相同的系結上執行進一步的連線導向作業，直到 NdisCmOpenAddressFamilyComplete 呼叫該客戶端為止 ProtocolClOpenAfCompleteEx 函式。
如果 NdisCmOpenAddressFamilyComplete 的呼叫端將 Status 設定為 NDIS_STATUS_SUCCESS，NDIS 接著會將指定的 CallMgrAfContext 句柄當做輸入參數傳遞給所有 CM 提供的 ProtocolCmXxx 和 ProtocolCoXxx 函式，該函式會涉及用戶端開啟位址系列，直到用戶端關閉 AF 為止。 呼叫管理員應該釋放或重複使用它配置的任何 AF 內容區域，再將失敗狀態傳遞給 NdisCmOpenAddressFamilyComplete。
針對成功的開啟， NDIS 提供的 NdisAfHandle 代表呼叫管理員與客戶端之間的關聯，代表呼叫管理員和用戶端在呼叫管理員和用戶端所系結的特定迷你埠驅動程式上開啟的 AF 之間的關聯。 這兩個通訊協定驅動程式都必須將 NdisAfHandle 視為不透明變數，才能在後續呼叫此句柄是必要參數的 NdisCl/Cm/CoXxx 函式中傳遞、未修改和未解譯。 若開啟失敗，當 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) |