NetAdapterCreate 函数 (netadapter.h)

创建 NETADAPTER 对象。

语法

NTSTATUS NetAdapterCreate(
  [_In_]     NETADAPTER_INIT       *AdapterInit,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *AdapterAttributes,
  [_Out_]    NETADAPTER            *Adapter
);

参数

[_In_] AdapterInit

指向 NETADAPTER_INIT 结构的指针,客户端驱动程序以前从 对 NetAdapterInitAllocate 的调用中接收该结构。

[_In_opt_] AdapterAttributes

指向调用方分配 的WDF_OBJECT_ATTRIBUTES 结构的指针。 结构的 ParentObject 必须为 NULL。 参数是可选的,可以WDF_NO_OBJECT_ATTRIBUTES。

[_Out_] Adapter

指向接收新 NETADAPTER 对象的句柄的位置的指针。

返回值

如果操作成功,函数将返回STATUS_SUCCESS。 否则,此函数可能会返回相应的 NTSTATUS 错误代码。

注解

调用 WdfDeviceCreate 后,客户端通常从其 EvtDriverDeviceAdd 例程中调用 NetAdapterCreate

有关创建 NETADAPTER 的代码示例,请参阅 设备初始化

NETADAPTER 对象是标准 WDF 对象。 框架管理其删除,删除父 WDFDEVICE 时会发生此删除。

要求

要求
目标平台 通用
最低 KMDF 版本 1.27
最低 UMDF 版本 2.33
标头 netadapter.h (包括 netadaptercx.h)
Library NetAdapterCxStub.lib
IRQL PASSIVE_LEVEL