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