NdisIMGetDeviceContext 関数 (ndis.h)

  • [アーティクル]

メモ NDIS 5。 x は非推奨となり、NDIS 6 に置き換えられます。 x があります。 新しい NDIS ドライバーの開発については、「 Windows Vista 以降のネットワーク ドライバー」を参照してください。 NDIS 5 の移植に関する情報。 x ドライバーから NDIS 6 へ。 x については、「 NDIS 5.x ドライバーを NDIS 6.0 に移植する」を参照してください。

この関数を使用すると、NDIS 中間ドライバーの MiniportInitialize 関数は、 ProtocolBindAdapter 関数によって割り当てられたデバイス コンテキスト領域にアクセスできます。

構文

NDIS_HANDLE NdisIMGetDeviceContext(
  [in] NDIS_HANDLE MiniportAdapterHandle
);

パラメーター

[in] MiniportAdapterHandle

MiniportInitialize へのハンドル入力を指定します。

戻り値

次の表に、この関数の戻り値を示します。

値 説明
NDISIMGETDEVICECONTEXT MiniportAdapterHandle によって識別される仮想 NIC のデバイス コンテキスト領域へのアクセスを返します。
NULL ドライバーの ProtocolBindAdapter 関数がこのようなデバイス コンテキスト領域を割り当てなかった場合。

注釈

NDIS 中間ドライバーの MiniportInitialize 関数は 、NdisIMGetDeviceContext を呼び出して、初期化中の仮想 NIC のデバイス コンテキスト領域にアクセスします。 通常、このような領域のメモリは、中間ドライバーの ProtocolBindAdapter 関数によって提供されます。この関数は NdisIMInitializeDeviceInstanceEx をこの領域へのポインターで呼び出し、ドライバーの MiniportInitialize 関数を呼び出します。 ただし、中間ドライバーは、このようなコンテキスト領域を持っている必要はありません。

NdisIMGetDeviceContext から返されると、MiniportInitialize は仮想 NIC のドライバー定義状態を設定します。中間ドライバー ライターが、その後に仮想 NIC にバインドする上位レベルのプロトコルに役立つ情報を設定します。

同じ仮想 NIC にバインドされたさらに高いレベルの NDIS プロトコルは、その後、ProtocolBindAdapter 関数から NdisIMGetBindingContext を呼び出すことによって、このデバイス コンテキスト領域にアクセスできます。

OS バージョン: .NET 4.0 以降Windows CE。

要件

要件 値
Header ndis.h
Library Ndis.lib
IRQL IRQL <= DISPATCH_LEVEL

こちらもご覧ください