MINIPORT_CO_ACTIVATE_VC回呼函式 (ndis.h)

  • 發行項

聯機導向迷你埠需要MiniportCoActivateVc函式。 MiniportCoActivateVc 是由 NDIS 呼叫，以向迷你埠驅動程式指出正在啟動虛擬連線。

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

語法

MINIPORT_CO_ACTIVATE_VC MiniportCoActivateVc;

NDIS_STATUS MiniportCoActivateVc(
  [in]      NDIS_HANDLE MiniportVcContext,
  [in, out] PCO_CALL_PARAMETERS CallParameters
)
{...}

參數

[in] MiniportVcContext

指定迷你埠驅動程式配置的內容區域的句柄，迷你埠驅動程式會維護其每個 VC 狀態。 迷你埠驅動程式已從 其MiniportCoCreateVc 函式提供此句柄給NDIS。

[in, out] CallParameters

指定要為此 VC 建立的呼叫管理員所指定的呼叫參數。 在輸出時，如果 CO_CALL_PARAMETERS結構中 設定了特定旗標，迷你埠驅動程式會傳回改變的呼叫參數。

傳回值

傳回碼 Description
NDIS_STATUS_SUCCESS
 表示已成功啟動 VC。
NDIS_STATUS_PENDING
 表示迷你埠驅動程式將會完成以異步方式啟動 VC 的要求。 當迷你埠驅動程式完成其作業時，它必須呼叫 NdisMCoActivateVcComplete。
NDIS_STATUS_INVALID_DATA
 表示此迷你埠驅動程式支援的媒體類型在 CallParameters 中指定的呼叫參數無效或不合法。
NDIS_STATUS_RESOURCES
 指出迷你埠驅動程式無法啟動 VC，因為它無法配置迷你埠驅動程式維護作用中 VC 狀態資訊所需的所有必要資源。

備註

迷你埠驅動程式必須驗證此 VC 的呼叫參數，如 CallParameters 中所指定，以確認配接器可支援要求的呼叫。 如果無法滿足要求的呼叫參數，迷你埠驅動程序應該會讓要求失敗，並NDIS_STATUS_INVALID_DATA。

您可以針對單一 VC 多次呼叫 MiniportCoActivateVc，以變更已使用中呼叫的呼叫參數。 每次呼叫時，迷你埠驅動程式都應該驗證參數，並視其配接器的需求執行任何處理，以滿足要求。 不過，如果無法設定指定的呼叫參數， MiniportCoActivateVc 必須讓 VC 保持可用狀態，因為連接導向用戶端或呼叫管理員可以使用較舊的呼叫參數繼續傳送或接收數據。

如果在 CallParameters-MediaParameters-Flags>> 的呼叫參數結構中設定ROUND_UP_FLOW或ROUND_DOWN_FLOW旗標，則迷你埠驅動程式已要求在流量速率根據已設定的適當旗標四捨五入後傳回 VC 的實際流量速率。 如果迷你埠驅動程式確實變更任何呼叫參數，因為這些旗標已設定，則必須傳回 在 CallParameters 上用於 VC 的實際呼叫參數。

如果可接受呼叫參數， MiniportCoActivateVc 會視需要與其配接器通訊，以準備適配卡以在虛擬連線 (接收或傳輸數據，換句話說，程式設計接收緩衝區) 。

例子

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

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

MINIPORT_CO_ACTIVATE_VC MyCoActivateVc;

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

_Use_decl_annotations_
NDIS_STATUS
 MyCoActivateVc(
    NDIS_HANDLE  MiniportVcContext,
    PCO_CALL_PARAMETERS  CallParameters
    )
  {...}

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

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

規格需求

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

另請參閱

MiniportCoCreateVc

MiniportCoDeactivateVc

NdisMCoActivateVcComplete