共用方式為


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

另請參閱

NdisAllocateFromNPagedLo,sideList

NdisClRegisterSap

NdisMCmRegisterSapComplete

ProtocolClRegisterSapComplete

ProtocolCmRegisterSap