共用方式為

MINIPORT_CO_CREATE_VC回呼函式 （ndis.h）

  • 發行項

聯機導向迷你埠需要 MiniportCoCreateVc 函式。 MiniportCoCreateVc 是由 NDIS 呼叫，以向迷你埠驅動程式指出正在建立新的 VC。

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

語法

MINIPORT_CO_CREATE_VC MiniportCoCreateVc;

NDIS_STATUS MiniportCoCreateVc(
  [in]  NDIS_HANDLE MiniportAdapterContext,
  [in]  NDIS_HANDLE NdisVcHandle,
  [out] PNDIS_HANDLE MiniportVcContext
)
{...}

參數

[in] MiniportAdapterContext

指定迷你埠驅動程式配置的內容區域的句柄，迷你埠驅動程式會維護此適配卡實例的狀態資訊。 迷你埠驅動程式藉由呼叫 ，將此句柄提供給 NDIS NdisMSetMiniportAttributes MiniportInitializeEx 函式。

[in] NdisVcHandle

指定由 NDIS 提供的句柄，可唯一識別所建立的 VC。 此句柄對迷你埠驅動程式不透明，並保留供 NDIS 連結庫使用。

[out] MiniportVcContext

指定在輸出時，迷你埠驅動程式所提供內容區域的句柄，迷你埠驅動程式會維護 VC 的狀態。

傳回值

傳回碼 描述
NDIS_STATUS_SUCCESS
 表示迷你埠驅動程式已成功配置所有必要的資源，並自行準備處理新建立 VC 的要求。
NDIS_STATUS_RESOURCES
 表示呼叫管理員無法取得動態配置的資源，使其無法在新的 VC 上運作。

言論

MiniportCoCreateVc 必須寫入為同步函式，而且在任何情況下，都無法傳回NDIS_STATUS_PENDING，而不會造成全系統失敗。

MiniportCoCreateVc 配置迷你埠驅動程式維護 VC 狀態資訊所需的任何必要資源。 這些資源可以包含，但不限於記憶體緩衝區、事件、數據結構，以及其他類似的資源。

設定所有必要的資源之後，miniport 驅動程式應該將資源初始化為可用狀態，並傳回 MiniportVcContext 中狀態區域的指標。 句柄的設定方式是取值句柄，並將狀態緩衝區的指標儲存為句柄的值。 例如：

*MiniportVcContext = SomeBuffer;

迷你埠驅動程式 必須 將句柄儲存到 VC，NdisVcHandle，因為這是迷你埠驅動程序後續呼叫之其他 NDIS 連結庫例程的必要參數。

範例

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

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

MINIPORT_CO_CREATE_VC MyCoCreateVc;

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

_Use_decl_annotations_
NDIS_STATUS
 MyCoCreateVc(
    NDIS_HANDLE  MiniportAdapterContext,
    NDIS_HANDLE  NdisVcHandle,
    PNDIS_HANDLE  MiniportVcContext
    )
  {...}

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

如需 Use_decl_annotations的相關信息，請參閱 批注函式行為。

要求

要求 價值
最低支援的用戶端 Windows Vista 中支援 NDIS 6.0 和 NDIS 5.1 驅動程式（請參閱 MiniportCoCreateVc （NDIS 5.1）。 支援 Windows XP 中的 NDIS 5.1 驅動程式 （請參閱 MiniportCoCreateVc （NDIS 5.1）。
目標平臺 窗戶
標頭 ndis.h （包括 Ndis.h）
IRQL <= DISPATCH_LEVEL

另請參閱

MiniportInitializeEx

NdisMSetMiniportAttributes