NdisMCmRegisterSapComplete 宏 (ndis.h)

發行項
03/01/2024

NdisMCmRegisterSapComplete 會傳回用戶端要求的最終狀態，MCM 驅動程式為其

ProtocolCmRegisterSap 函式先前傳回NDIS_STATUS_PENDING，以註冊 SAP。

語法

void NdisMCmRegisterSapComplete(
   _S_,
   _H_,
   _C_
);

參數

_S_

指定用戶端原始要求的最終狀態，以註冊 SAP，NDIS_STATUS_SUCCESS或任何呼叫端決定的NDIS_STATUS_XXX，但NDIS_STATUS_PENDING除外。

_H_

如果註冊成功，則指定SAP的NDIS提供句柄。呼叫管理員取得此句柄做為其 ProtocolCmRegisterSap 函式的輸入參數。

_C_

指定呼叫端提供的駐留內容區域的句柄，如果註冊成功，MCM 驅動程式會維護此 SAP 的狀態。若是如此，NDIS 會將此句柄傳回至 MCM 驅動程式，並在後續有關此 SAP 的所有呼叫中傳遞回 MCM 驅動程式。如果 Status 設定為 NDIS_STATUS_SUCCESS 以外的專案，NDIS 會忽略此參數。

傳回值

無

備註

如果 MCM 驅動程式的 ProtocolCmRegisterSap 函式使用指定的 NdisSapHandle 呼叫時，必須呼叫 NdisMCmRegisterSapComplete NDIS_STATUS_PENDING。 對 NdisMCmRegisterSapComplete 的呼叫會導致 NDIS 呼叫用戶端的 ProtocolClRegisterSapComplete 函式。

如果 MCM 驅動程式將 Status 設定為 NDIS_STATUS_SUCCESS 以外的任何專案，當 NdisMCmRegisterSapComplete 傳回控件時，它應該考慮 NdisSapHandle 無效。失敗 SAP 註冊之後，CM 可以釋放或重複使用已配置的個別 SAP 內容區域。如果 MCM 驅動程式註冊失敗，NDIS 也會釋放 SAP 的內容。

只有提供整合式呼叫管理支持的連線導向迷你埠驅動程式可以呼叫 NdisMCmRegisterSapComplete。獨立呼叫管理員，其向NDIS註冊為通訊協定驅動程式，改為呼叫 NdisCmRegisterSapComplete 。

規格需求

需求	值
最低支援的用戶端	支援 NDIS 6.0 和 NDIS 5.1 驅動程式 (請參閱 Windows Vista 中的 NdisMCmRegisterSapComplete (NDIS 5.1) ) 。支援 NDIS 5.1 驅動程式 (請參閱 Windows XP 中的 NdisMCmRegisterSapComplete (NDIS 5.1) ) 。
目標平台	桌面
標頭	ndis.h (包括 Ndis.h)
IRQL	<= DISPATCH_LEVEL
DDI 合規性規則	Irql_MCM_Function (ndis)