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 |