NdisCmRegisterSapComplete 函式 (ndis.h)
NdisCmRegisterSapComplete 會傳回用戶端要求的最終狀態,CM 先前傳回NDIS_STATUS_PENDING,以註冊 SAP。
語法
void NdisCmRegisterSapComplete(
[in] NDIS_STATUS Status,
[in] NDIS_HANDLE NdisSapHandle,
[in] NDIS_HANDLE CallMgrSapContext
);
參數
[in] Status
指定用戶端原始要求的最終狀態,以註冊 SAP,NDIS_STATUS_SUCCESS或任何 CM 決定NDIS_STATUS_XXX ,但NDIS_STATUS_PENDING除外。
[in] NdisSapHandle
指定註冊成功時,為 SAP 提供的 NDIS 句柄。 呼叫管理員取得此句柄做為其輸入參數 ProtocolCmRegisterSap 函式。
[in] CallMgrSapContext
指定呼叫端提供的駐留內容區域的句柄,如果註冊成功,CM 會維護此 SAP 的狀態。 如果是的話,NDIS 會將此句柄傳回 CM,並在後續有關此 SAP 的所有呼叫中傳遞回 CM。 如果 Status 設定為 NDIS_STATUS_SUCCESS 以外的專案,NDIS 會忽略此參數。
傳回值
無
備註
獨立呼叫管理員必須呼叫 NdisCmRegisterSapComplete ,如果其 ProtocolCmRegisterSap 函式以指定的 NdisSapHandle 呼叫時傳回NDIS_STATUS_PENDING。 呼叫 NdisCmRegisterSapComplete 會導致 NDIS 呼叫用戶端的 ProtocolClRegisterSapComplete 函式 。
如果呼叫管理員將 Status 設定為NDIS_STATUS_SUCCESS以外的任何專案,它應該在呼叫 NdisCmRegisterSapComplete 時立即將 NdisSapHandle 視為無效。 失敗 SAP 註冊之後,CM 可以釋放或重複使用 當 NdisCmRegisterSapComplete 傳回控件時所配置的個別 SAP 內容區域。 如果呼叫管理員失敗,NDIS 也會釋放 SAP 的內容。
只有向 NDIS 註冊為通訊協定驅動程式的獨立呼叫管理員,才能呼叫 NdisCmRegisterSapComplete。 提供整合式呼叫管理支援呼叫 NdisMCmRegisterSapComplete 的連接導向迷你埠驅動程式。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 支援 NDIS 6.0 和 NDIS 5.1 驅動程式 (請參閱 Windows Vista 中的 NdisCmRegisterSapComplete (NDIS 5.1) ) 。 支援 NDIS 5.1 驅動程式 (請參閱 Windows XP 中的 NdisCmRegisterSapComplete (NDIS 5.1) ) 。 |
目標平台 | 桌面 |
標頭 | ndis.h (包含 Ndis.h) |
程式庫 | Ndis.lib |
IRQL | <= DISPATCH_LEVEL |
DDI 合規性規則 | Irql_CallManager_Function () |