Функция NetAdapterCreate (netadapter.h)

Статья
02/07/2025

Создает объект 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клиент обычно вызывает NetAdapterCreate из подпрограммы EvtDriverDeviceAdd.

Пример кода создания NETADAPTER см. в инициализации устройств.

Объект NETADAPTER является стандартным объектом WDF. Платформа управляет его удалением, которое происходит при удалении родительского WDFDEVICE.

Требования

Требование	Ценность
целевая платформа	Всеобщий
минимальная версия KMDF	1.27
минимальная версия UMDF	2.33
заголовка	netadapter.h (include netadaptercx.h)
библиотеки	NetAdapterCxStub.lib
IRQL	PASSIVE_LEVEL

Поделиться через