Функция 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 (include netadaptercx.h) |
| библиотеки | netadaptercxstub.lib |
| IRQL | PASSIVE_LEVEL |