EVT_MBB_DEVICE_CREATE_ADAPTER コールバック関数 (mbbcx.h)

  • [アーティクル]

EvtMbbDeviceCreateAdapter コールバック関数は、データ セッション用の NETADAPTER オブジェクトを作成するためにクライアント ドライバーによって実装されます。

構文

EVT_MBB_DEVICE_CREATE_ADAPTER EvtMbbDeviceCreateAdapter;

NTSTATUS EvtMbbDeviceCreateAdapter(
  WDFDEVICE Device,
  NETADAPTER_INIT *AdapterInit
)
{...}

パラメーター

Device

WdfDeviceCreate の以前の呼び出しから取得したクライアント ドライバーのフレームワーク デバイス オブジェクトへのハンドル。

AdapterInit

NETADAPTER の初期化情報を記述するNETADAPTER_INIT オブジェクト。

戻り値

このコールバック関数は、操作が成功した場合にSTATUS_SUCCESSを返します。 それ以外の場合は、適切な NTSTATUS エラー コードが返されます。

注釈

MBBCx クライアント ドライバーは、MbbDeviceInitialize を呼び出して EvtMbbDeviceCreateAdapter コールバック関数を登録する必要があります。

このコールバックでは、クライアント ドライバーは、データ セッションのネットワーク インターフェイスを表すために MBBCx によって使用される NETADAPTER オブジェクトを作成します。 MBBCx は、このコールバック関数を少なくとも 1 回呼び出してプライマリ PDP コンテキスト/既定の EPS ベアラーを確立します。その後、データ セッションごとに 1 回、複数回呼び出す場合があります。

EvtMbbDeviceCreateAdapter から戻る前に、クライアント ドライバーは NetAdapterStart を呼び出してアダプターを起動する必要があります。 必要に応じて、NetAdapterStart の呼び出しの前にこれらの関数を 1 つ以上呼び出すことで、アダプターの機能を設定することもできます。

詳細とコード例については、「 PDP コンテキスト/EPS ベアラーの NetAdapter インターフェイスの作成」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows 10 バージョン 1903
対象プラットフォーム ユニバーサル
最小 KMDF バージョン 1.29
Header mbbcx.h
IRQL PASSIVE_LEVEL