次の方法で共有


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
UMDF の最小バージョン する 2.33
ヘッダー netadapter.h (netadaptercx.h を含む)
ライブラリ NetAdapterCxStub.lib
IRQL PASSIVE_LEVEL