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 驅動程式先前針對指定的 NdisAfHandle 傳回 NDIS_STATUS_PENDING的 ProtocolCmOpenAf 函式,則必須呼叫 NdisMCmOpenAddressFamilyComplete 。 起始手寫筆開啟 AF 作業且呼叫 NdisClOpenAddressFamilyEx 的客戶端無法在相同的系結上執行進一步的連線導向作業,直到 NdisMCmOpenAddressFamilyComplete 對該用戶端的呼叫為止 ProtocolClOpenAfCompleteEx 函 式。

如果 NdisMCmOpenAddressFamilyComplete 的呼叫端將 Status 設定為 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)

另請參閱

NdisAllocateFromNPagedLo,sideList

NdisClOpenAddressFamilyEx

NdisCmOpenAddressFamilyComplete

ProtocolClOpenAfCompleteEx

ProtocolCmOpenAf