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 構造体へのポインター。 構造体の ParentObject は NULL である必要があります。 パラメーターは省略可能であり、WDF_NO_OBJECT_ATTRIBUTESできます。

[_Out_] Adapter

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

戻り値

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

注釈

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

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

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

要件

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