PROTOCOL_CM_DEACTIVATE_VC_COMPLETE回呼函式 (ndis.h)

發行項
02/27/2024

ProtocolCmDeactivateVcComplete 函式是必要的函式。 ProtocolCmDeactivateVcComplete 會完成呼叫管理員起始的要求處理，基礎迷你埠驅動程式 (和 NDIS) 停用先前傳回NDIS_STATUS_PENDING的 VC。

注意您必須使用 PROTOCOL_CM_DEACTIVATE_VC_COMPLETE 類型來宣告函式。如需詳細資訊，請參閱下列範例一節。

語法

PROTOCOL_CM_DEACTIVATE_VC_COMPLETE ProtocolCmDeactivateVcComplete;

void ProtocolCmDeactivateVcComplete(
  [in] NDIS_STATUS Status,
  [in] NDIS_HANDLE CallMgrVcContext
)
{...}

參數

[in] Status

指定停用的最終狀態。

[in] CallMgrVcContext

指定呼叫管理員所配置內容區域的句柄，其中呼叫管理員會維護其每個 VC 狀態。呼叫管理員從其 ProtocolCoCreateVc 函式提供此句柄給 NDIS。

傳回值

無

備註

NDIS 通常會在呼叫管理員代表連線導向用戶端關閉呼叫的內容中呼叫 ProtocolCmDeactivateVcComplete 。呼叫管理員通常會從其 ProtocolCmCloseCall 函式呼叫 NdisCmDeactivateVc。每當 NdisCmDeactivateVc 傳回NDIS_STATUS_PENDING時，NDIS 接著會呼叫其 ProtocolCmDeactivateVcComplete 函式 。

也就是說，當基礎連線導向迷你埠驅動程式已停用 VC 時，NDIS 會呼叫 ProtocolCmDeactivateVcComplete。在 狀態中找到停用 的最終狀態。最終狀態的可能值包括，但不限於：

ProtocolCmDeactivateVcComplete 會執行完成虛擬連線停用所需的任何後置處理，例如在其狀態區域中設定旗標，以指出連線處於非作用中狀態，或釋放在 VC 作用中時使用的動態配置資源。

停用完成表示啟用時所使用的 VC 的所有呼叫參數都不再有效。除了使用一組新的呼叫參數重新啟用之外，禁止進一步使用 VC。

呼叫管理員應該釋放為 VC 啟用配置的任何資源，並儘快傳回控制權。如果呼叫管理員先前從其 ProtocolCmCloseCall 函式傳回NDIS_STATUS_PENDING，而且關閉呼叫的所有作業都已完成， ProtocolCmDeactivateVcComplete 現在應該呼叫 NdisCmCloseCallComplete。

例子

若要定義 ProtocolCmDeactivateVcComplete 函式，您必須先提供函式宣告來識別您要定義的函式類型。 Windows 提供一組驅動程式的函式類型。使用函式類型宣告函式有助於驅動程式的程式代碼分析、靜態驅動程序驗證器 (SDV) ，以及其他驗證工具會尋找錯誤，而且這是撰寫 Windows 操作系統驅動程式的需求。

例如，若要定義名為「 MyCmDeactivateVcComplete」的 ProtocolCmDeactivateVcComplete 函式，請使用 PROTOCOL_CM_DEACTIVATE_VC_COMPLETE 類型，如下列程式代碼範例所示：

PROTOCOL_CM_DEACTIVATE_VC_COMPLETE MyCmDeactivateVcComplete;

然後，實作您的函式，如下所示：

_Use_decl_annotations_
VOID
 MyCmDeactivateVcComplete(
    NDIS_STATUS  Status,
    NDIS_HANDLE  CallMgrVcContext
    )
  {...}

PROTOCOL_CM_DEACTIVATE_VC_COMPLETE函式類型定義於 Ndis.h 頭檔中。若要在執行程式代碼分析工具時更精確地識別錯誤，請務必將 Use_decl_annotations 註釋新增至函式定義。 Use_decl_annotations註釋可確保使用頭檔中套用至PROTOCOL_CM_DEACTIVATE_VC_COMPLETE函式類型的批註。如需函式宣告需求的詳細資訊，請參閱使用 NDIS 驅動程式的函式角色類型來宣告函式。

如需 Use_decl_annotations的詳細資訊，請參閱標註函式行為。

規格需求

需求	值
最低支援的用戶端	支援 NDIS 6.0 和 NDIS 5.1 驅動程式 (請參閱 Windows Vista 中的 ProtocolCmDeactivateVcComplete (NDIS 5.1) ) 。支援 NDIS 5.1 驅動程式 (請參閱 Windows XP 中的 ProtocolCmDeactivateVcComplete (NDIS 5.1) ) 。
目標平台	Windows
標頭	ndis.h (包括 Ndis.h)
IRQL	<= DISPATCH_LEVEL