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 |
| ヘッダー | netadapter.h (netadaptercx.h を含む) |
| ライブラリ | netadaptercxstub.lib |
| IRQL | PASSIVE_LEVEL |