NetAdapterInitAllocate 関数 (netadapter.h)

NetAdapterInitAllocate 関数は、新しい NETADAPTER オブジェクトを作成するときにクライアントドライバーが使用するNETADAPTER_INIT構造体を割り当てます。

構文

NETADAPTER_INIT * NetAdapterInitAllocate(
  [_In_] WDFDEVICE Device
);

[_In_] Device

フレームワークデバイスオブジェクトへのハンドル。

操作が成功した場合は、フレームワークによって割り当てられたNETADAPTER_INIT構造体へのポインターを返します。それ以外の場合、この関数は NULL を返します。

重要

クライアントドライバーがこの関数の正常な呼び出しからNETADAPTER_INIT構造体を受け取った場合、ドライバーは常に NetAdapterInitFree を呼び出して 、NetAdapterCreate の結果に関係なく割り当てを解除する必要があります。

クライアントドライバーは NetAdapterInitAllocate を呼び出して、 NetAdapterCreate に渡すことができるNETADAPTER_INIT構造体を取得します。

NetAdapterInitAllocate が成功した後、クライアントドライバーは必要に応じて NetAdapterInitSetXxx 関数を呼び出して、NETADAPTER の初期化属性をさらに設定できます。

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

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