NetAdapterCreate 函数 (netadapter.h)
创建 NETADAPTER 对象。
NTSTATUS NetAdapterCreate(
[_In_] NETADAPTER_INIT *AdapterInit,
[_In_opt_] WDF_OBJECT_ATTRIBUTES *AdapterAttributes,
[_Out_] NETADAPTER *Adapter
);
[_In_] AdapterInit
指向客户端驱动程序以前从调用 NetAdapterInitAllocate收到的 NETADAPTER_INIT 结构的指针。
[_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) |
库 | NetAdapterCxStub.lib |
IRQL | PASSIVE_LEVEL |