OPEN_NDK_ADAPTER_HANDLER コールバック関数 (ndisndk.h)

[アーティクル]
08/07/2023

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

NDK_ADAPTER インスタンスを開く入力パラメーターを定義するNDIS_OPEN_NDK_ADAPTER_PARAMETERS構造体へのポインター。

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 アプリケーションプログラミングインターフェイスを実装するディスパッチ関数のテーブルへのポインターが含まれています。ミニポートドライバーは、NDK アダプターインスタンスを閉じ、関連付けられているリソースを解放する CLOSE_NDK_ADAPTER_HANDLER 関数を呼び出します。

要件

要件	値
サポートされている最小のクライアント	サポートされていません。NDIS 6.30 以降でサポートされています。
サポートされている最小のサーバー	Windows Server 2012
対象プラットフォーム	Windows
ヘッダー	ndisndk.h
IRQL	PASSIVE_LEVEL