OPEN_NDK_ADAPTER_HANDLER回呼函式（ndisndk.h）

發行項
02/07/2025

OpenNDKAdapterHandler （OPEN_NDK_ADAPTER_HANDLER）函式會在支援 NDK 的 NDIS 迷你埠配接器上開啟 NDK 配接器實例。

語法

OPEN_NDK_ADAPTER_HANDLER OpenNdkAdapterHandler;

NDIS_STATUS OpenNdkAdapterHandler(
  [in] NDIS_HANDLE MiniportAdapterContext,
  [in] PNDIS_OPEN_NDK_ADAPTER_PARAMETERS Parameters,
       NDK_ADAPTER **ppNdkAdapter
)
{...}

參數

[in] MiniportAdapterContext

迷你埠驅動程式在其 MiniportInitializeEx 函式中配置的內容區域句柄。迷你埠驅動程式會使用此內容區域來維護 NDIS 迷你埠配接器的狀態資訊。

[in] Parameters

NDIS_OPEN_NDK_ADAPTER_PARAMETERS 結構的指標，定義要開啟 NDK_ADAPTER 實例的輸入參數。

NDIS_OPEN_NDK_ADAPTER_PARAMETERS 結構必須指定 NDKPI 主要版本，以及 NDK 取用者可支援的最低 NDKPI 次要版本。

如果提供者不支持取用者指定的主要版本，提供者必須以NDIS_STATUS_BAD_VERSION失敗要求。

如果提供者支持取用者指定的主要版本，且指定的次要版本小於或等於提供者支援的最高次要版本，提供者必須成功要求，並使用提供者支援的最高次要版本。

例如，如果取用者要求 1.0 版，且提供者支援 1.1，提供者必須在 NDK_ADAPTER_INFO 結構和 NDK 物件標頭中報告 1.1 版。

注意提供者的較高次要版本一律與較低次要版本完全回溯相容（也就是超集）。

如果提供者支持取用者指定的主要版本，且指定的次要版本大於提供者所支援的最高次要版本，則提供者必須失敗要求，並NDIS_STATUS_BAD_VERSION。

ppNdkAdapter

保存 NDK_ADAPTER 結構指標之變數的指標。從 OPEN_NDK_ADAPTER_HANDLER傳回時，ppNdkAdapter 所參考的 NDK_ADAPTER 結構 會識別新開啟的 NDK 配接器實例。

傳回值

OPEN_NDK_ADAPTER_HANDLER 可以傳回下列其中一個值：

傳回碼	描述
NDIS_STATUS_SUCCESS	已成功開啟 NDK 配接器實例。
NDIS_STATUS_BAD_VERSION	不支援要求的版本號碼。
NDIS_STATUS_ADAPTER_NOT_READY	迷你埠配接器的NDK功能未啟用。
NDIS_STATUS_RESOURCES	由於資源不足，NDIS 無法開啟 NDK 配接器。

言論

OPEN_NDK_ADAPTER_HANDLER 會在支援 NDK 的 NDIS 迷你埠配接器上開啟 NDK_ADAPTER 實例。您可以在相同的 NDIS 迷你埠適配卡上建立多個 NDK_ADAPTER 實例。每個 NDK_ADAPTER 實例都包含實作 NDK 應用程式程式設計介面之分派函式數據表的指標。迷你埠驅動程式會呼叫 CLOSE_NDK_ADAPTER_HANDLER 函式，以關閉 NDK 配接器實例並釋放相關聯的資源。

要求

要求	價值
最低支援的用戶端	不支援，在 NDIS 6.30 和更新版本中支援。
支援的最低伺服器	Windows Server 2012
目標平臺	窗戶
標頭	ndisndk.h
IRQL	PASSIVE_LEVEL