OPEN_NDK_ADAPTER_HANDLERコールバック関数 (ndisndk.h)
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
ミニポート ドライバーがその ミニポートInitializeEx 関数に割り当てられたコンテキスト領域へのハンドル。 ミニポート ドライバーは、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 を報告する必要があります。
ppNdkAdapter
NDK_ADAPTER 構造体へのポインターを保持する変数へのポインター。 OPEN_NDK_ADAPTER_HANDLERから戻った場合、ppNdkAdapter によって参照される NDK_ADAPTER 構造体は、新しく開かれた NDK アダプター インスタンスを識別します。
戻り値
OPEN_NDK_ADAPTER_HANDLER は、次のいずれかの値を返すことができます。
| リターン コード | 形容 |
|---|---|
|
NDK アダプター インスタンスが正常に開かれました。 |
|
要求されたバージョン番号はサポートされていません。 |
|
ミニポート アダプターの NDK 機能が有効になっていません。 |
|
リソースが不足しているため、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 |
| ターゲット プラットフォーム の | ウィンドウズ |
| ヘッダー | ndisndk.h |
| IRQL | PASSIVE_LEVEL |