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 |