共用方式為


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

另請參閱

裝置初始化

NetAdapterCreate

NetAdapterInitFree