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