Share via

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 的程式碼範例，請參閱 裝置初始化。

規格需求

需求 值
目標平台 Universal
最低 KMDF 版本 1.27
標頭 netadapter.h (包含 netadaptercx.h)
程式庫 netadaptercxstub.lib
IRQL PASSIVE_LEVEL

另請參閱

裝置初始化

NetAdapterCreate

NetAdapterInitFree