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 |