MINIPORT_CO_CREATE_VC回呼函式 (ndis.h)

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

注意 您必須使用 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 from its MiniportInitializeEx 函式。

[in] NdisVcHandle

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

[out] MiniportVcContext

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

傳回值

傳回碼	Description
NDIS_STATUS_SUCCESS	表示迷你埠驅動程式已成功配置所有必要的資源，並備妥本身來處理新建立 VC 的要求。
NDIS_STATUS_RESOURCES	表示呼叫管理員無法取得在新的 VC 上操作所需的動態配置資源。

備註

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

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

配置所有必要的資源之後，迷你埠驅動程式應該將資源初始化為可用狀態，並傳回 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的詳細資訊，請參閱 標註函式行為。

規格需求

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

另請參閱

MiniportInitializeEx

NdisMSetMiniportAttributes