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 |
标头 | netadapter.h (包括 netadaptercx.h) |
Library | NetAdapterCxStub.lib |
IRQL | PASSIVE_LEVEL |
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈