NdisCmDropPartyComplete 函式 (ndis.h)
NdisCmDropPartyComplete 會傳回用戶端要求的最終狀態,呼叫管理員先前傳回NDIS_STATUS_PENDING,以從多點 VC 移除合作物件。
語法
void NdisCmDropPartyComplete(
[in] NDIS_STATUS Status,
[in] NDIS_HANDLE NdisPartyHandle
);
參數
[in] Status
指定所要求作業的最終狀態,NDIS_STATUS_SUCCESS或任何 CM 判斷NDIS_STATUS_ XXX ,但NDIS_STATUS_PENDING除外。
[in] NdisPartyHandle
指定用戶端要求卸除之合作物件的句柄。 呼叫管理員會從 CallMgrPartyContext 所指定的狀態區域取得此句柄,該狀態區域已傳遞為輸入參數至其 ProtocolCmDropParty 函式 。
傳回值
無
備註
獨立呼叫管理員必須呼叫 NdisCmDropPartyComplete ,如果其 ProtocolCmDropParty 函式先前針對指定的 NdisPartyHandle 傳回NDIS_STATUS_PENDING。 在 CM 呼叫 NdisCmDropPartyComplete 之前,NDIS 或用戶端都無法透過呼叫 NdisClDropParty 來起始手寫的卸除合作物件作業,才能釋放其配置來維護每一方狀態的資源,直到 CM 呼叫 NdisCmDropPartyComplete 才會呼叫該用戶端 ProtocolClDropPartyComplete 函式 。
如果它傳遞狀態NDIS_STATUS_SUCCESS,呼叫管理員應該在呼叫 NdisCmDropPartyComplete 時,考慮 NdisPartyHandle 無效。 當 NdisCmDropPartyComplete 傳回控件時,CM 可以釋放 (或重新初始化,以) 重複使用它配置來維護此合作對象狀態的任何資源。
只有向 NDIS 註冊為通訊協定驅動程式的獨立呼叫管理員,才能呼叫 NdisCmDropPartyComplete。 提供整合式呼叫管理支援的連線導向迷你埠驅動程式會改為呼叫 NdisMCmDropPartyComplete 。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 支援 NDIS 6.0 和 NDIS 5.1 驅動程式 (請參閱 Windows Vista 中的 NdisCmDropPartyComplete (NDIS 5.1) ) 。 支援 NDIS 5.1 驅動程式 (請參閱 Windows XP 中的 NdisCmDropPartyComplete (NDIS 5.1) ) 。 |
目標平台 | 桌面 |
標頭 | ndis.h (包括 Ndis.h) |
程式庫 | Ndis.lib |
IRQL | <= DISPATCH_LEVEL |
DDI 合規性規則 | Irql_CallManager_Function (ndis) |