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 啟用,在迷你埠驅動程式呼叫 NdisMCoActivateVcComplete之前,無法通知 NDIS 或其用戶端是否可以使用提供的呼叫參數進行傳輸。
如果迷你埠驅動程序發現 CM 提供的呼叫參數無法接受,它會在呼叫 NdisMCoActivateVcComplete時失敗 VC 啟用。 如果 VC 的初始啟用失敗,可能會導致建立 VC 的通訊協定卸除。 如果迷你埠驅動程式無法要求以新的呼叫參數重新啟用已建立的 VC,則必須還原為該 VC 建立的原始呼叫參數。 根據網路媒體的性質,迷你埠驅動程式可以在呼叫 NdisMCoActivateVcComplete之前設定進位和/或向下捨入旗標時修改媒體參數。
呼叫 NdisMCoActivateVcComplete 會導致 NDIS 呼叫 ProtocolCmActivateVcComplete 原本要求 VC 啟用的呼叫管理員函式。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 支援 Windows Vista 中的 NDIS 6.0 和 NDIS 5.1 驅動程式(請參閱 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(ndis) |