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 |