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

  • Статья

Функция NetAdapterInitAllocate выделяет структуру NETADAPTER_INIT, которую драйвер клиента использует при создании нового объекта NETADAPTER.

Синтаксис

NETADAPTER_INIT * NetAdapterInitAllocate(
  [_In_] WDFDEVICE Device
);

Параметры

[_In_] Device

Дескриптор объекта устройства платформы.

Возвращаемое значение

Возвращает указатель на структуру, выделенную платформой NETADAPTER_INIT, если операция выполнена успешно. В противном случае эта функция возвращает значение NULL.

Важно!

Если драйвер клиента получает NETADAPTER_INIT структуру из успешного вызова этой функции, драйвер должен всегда вызывать NetAdapterInitFree , чтобы освободить его, независимо от результата NetAdapterCreate.

Комментарии

Драйвер клиента вызывает NetAdapterInitAllocate , чтобы получить структуру NETADAPTER_INIT, которую он может передать в NetAdapterCreate.

После успешного выполнения NetAdapterInitAllocate клиентские драйверы могут при необходимости вызывать функции NetAdapterInitSetXxx , чтобы задать дополнительные атрибуты инициализации для NETADAPTER.

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

Требования

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

См. также раздел

Инициализация устройства

NetAdapterCreate

NetAdapterInitFree