Функция 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 клиент обычно вызывает NetAdapterCreate из своей подпрограммы EvtDriverDeviceAdd .

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

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

Требования

Требование Значение
Целевая платформа Универсальное
Минимальная версия KMDF 1.27
Верхняя часть netadapter.h (включая netadaptercx.h)
Библиотека NetAdapterCxStub.lib
IRQL PASSIVE_LEVEL