NdisMCoActivateVcComplete 函式 (ndis.h)
NdisMCoActivateVcComplete 會通知 NDIS 和呼叫管理員,迷你埠驅動程式已完成 CM 起始的 activate-VC 要求,而迷你埠驅動程式先前會傳回NDIS_STATUS_PENDING。
語法
void NdisMCoActivateVcComplete(
[in] NDIS_STATUS Status,
[in] NDIS_HANDLE NdisVcHandle,
[in] PCO_CALL_PARAMETERS CallParameters
);
參數
[in] Status
指定 activate-VC 作業的最終狀態,它可以NDIS_STATUS_SUCCESS或任何 NDIS_STATUS_ XXX,但NDIS_STATUS_PENDING除外 。
[in] NdisVcHandle
指定識別 VC 的句柄。 呼叫端會從其每個 VC 狀態取得此句柄,並由 MiniportVcContext 指定作為輸入參數傳遞給它的 MiniportCoActivateVc 函式。
[in] CallParameters
CO_CALL_PARAMETERS類型結構的指標,由呼叫管理員提供,指定 VC 啟用的呼叫和媒體參數。
傳回值
無
備註
聯機導向迷你埠驅動程序必須呼叫 NdisMCoActivateVcComplete ,如果其 MiniportCoActivateVc 函式先前傳回NDIS_STATUS_PENDING,以響應啟動或重新啟用指定 NdisVcHandle 所識別的 VC 要求。 呼叫管理員透過呼叫 NdisCmActivateVc 起始 VC 啟用,無法通知 NDIS 或其用戶端是否可以使用提供的呼叫參數進行傳輸,直到迷你埠驅動程式呼叫 NdisMCoActivateVcComplete 為止。
如果迷你埠驅動程序發現 CM 提供的呼叫參數無法接受,它會在呼叫 NdisMCoActivateVcComplete 時失敗 VC 啟用。 VC 的初始啟用失敗,可能會導致建立 VC 的通訊協定將其終止。 如果迷你埠驅動程式無法要求以新的呼叫參數重新啟用已建立的 VC,則必須還原為該 VC 建立的原始呼叫參數。 視網路媒體的性質而定,如果捨入和/或捨入旗標 () 設定,迷你埠驅動程式就可以修改媒體參數,然後再呼叫 NdisMCoActivateVcComplete。
呼叫 NdisMCoActivateVcComplete 會導致 NDIS 呼叫原本要求 VC 啟用之呼叫管理員的 ProtocolCmActivateVcComplete 函式。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 支援 NDIS 6.0 和 NDIS 5.1 驅動程式 (請參閱 Windows Vista 中的 NdisMCoActivateVcComplete (NDIS 5.1) ) 。 (支援 NDIS 5.1 驅動程式,請參閱 Windows XP 中的 NdisMCoActivateVcComplete (NDIS 5.1) ) 。 |
目標平台 | 桌面 |
標頭 | ndis.h (包含 Ndis.h) |
程式庫 | Ndis.lib |
IRQL | <= DISPATCH_LEVEL |
DDI 合規性規則 | Irql_MCO_Function () |