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) |