NetAdapterInitAllocate 函式 (netadapter.h)
NetAdapterInitAllocate 函式會配置客戶端驅動程式在建立新的 NETADAPTER 物件時所使用的NETADAPTER_INIT結構。
語法
NETADAPTER_INIT * NetAdapterInitAllocate(
[_In_] WDFDEVICE Device
);
參數
[_In_] Device
架構裝置物件的句柄。
傳回值
如果作業成功，則會傳回架構配置的NETADAPTER_INIT結構的指標。 否則，此函式會傳回 NULL。
重要
如果客戶端驅動程式從成功呼叫此函式收到NETADAPTER_INIT結構，則不論 NetAdapterCreate 的結果為何，驅動程式都必須一律呼叫 NetAdapterInitFree 來解除分配它。
備註
用戶端驅動程式會呼叫 NetAdapterInitAllocate ，以取得可傳遞至 NetAdapterCreate 的NETADAPTER_INIT結構。
NetAdapterInitAllocate 成功之後，用戶端驅動程式可以選擇性地呼叫 NetAdapterInitSetXxx 函式，以設定 NETADAPTER 的進一步初始化屬性。
如需建立 NETADAPTER 的程式碼範例，請參閱 裝置初始化。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Universal |
| 最小 KMDF 版本 | 1.27 |
| 最低UMDF版本 | 2.33 |
| 標頭 | netadapter.h (包括 netadaptercx.h) |
| 程式庫 | netadaptercxstub.lib |
| IRQL | PASSIVE_LEVEL |