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) |
| Library | netadaptercxstub.lib |
| IRQL | PASSIVE_LEVEL |