Функция 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 |
| Минимальная версия UMDF | 2.33 |
| Верхняя часть | netadapter.h (включая netadaptercx.h) |
| Библиотека | netadaptercxstub.lib |
| IRQL | PASSIVE_LEVEL |