OPEN_NDK_ADAPTER_HANDLER回呼函式 (ndisndk.h)

發行項
02/29/2024

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 可以傳回下列其中一個值：

傳回碼	Description
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
目標平台	Windows
標頭	ndisndk.h
IRQL	PASSIVE_LEVEL