NetAdapterCreate 関数 (netadapter.h)

NETADAPTER オブジェクトを作成します。

構文

NTSTATUS NetAdapterCreate(
  [_In_]     NETADAPTER_INIT       *AdapterInit,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *AdapterAttributes,
  [_Out_]    NETADAPTER            *Adapter
);

パラメーター

[_In_] AdapterInit

クライアント ドライバーが NetAdapterInitAllocate の呼び出しから以前に受信したNETADAPTER_INIT構造体へのポインター。

[_In_opt_] AdapterAttributes

呼び出し元によって割り当てられた WDF_OBJECT_ATTRIBUTES 構造体へのポインター。 構造体の ParentObjectNULL である必要があります。 パラメーターは省略可能であり、WDF_NO_OBJECT_ATTRIBUTESできます。

[_Out_] Adapter

新しい NETADAPTER オブジェクトへのハンドルを受け取る場所へのポインター。

戻り値

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

注釈

WdfDeviceCreate を呼び出した後、クライアントは通常、EvtDriverDeviceAdd ルーチン内から NetAdapterCreate を呼び出します。

NETADAPTER を作成するコード例については、「 デバイスの初期化」を参照してください。

NETADAPTER オブジェクトは、標準の WDF オブジェクトです。 フレームワークは、親 WDFDEVICE が削除されたときに発生する削除を管理します。

要件

要件
対象プラットフォーム ユニバーサル
最小 KMDF バージョン 1.27
最小 UMDF バージョン 2.33
Header netadapter.h (netadaptercx.h を含む)
Library NetAdapterCxStub.lib
IRQL PASSIVE_LEVEL