共用方式為


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)

另請參閱

CO_CALL_PARAMETERS

MiniportCoActivateVc

NdisCmActivateVc

NdisCmDeactivateVc

ProtocolCmActivateVcComplete