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
ミニポート ドライバーがその 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 を報告する必要があります。
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 |
| 対象プラットフォーム | Windows |
| ヘッダー | ndisndk.h |
| IRQL | PASSIVE_LEVEL |