функция NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED (netadapter.h)
Функция NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED инициализирует структуру NET_ADAPTER_RX_CAPABILITIES для сетевого адаптера, который хотел бы указать выделение буфера буфера и вложение, управляемое драйвером.
Синтаксис
void NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED(
[_Out_] NET_ADAPTER_RX_CAPABILITIES *RxCapabilities,
[_In_] PFN_NET_ADAPTER_RETURN_RX_BUFFER EvtAdapterReturnRxBuffer,
[_In_] SIZE_T MaximumFrameSize,
[_In_] SIZE_T MaximumNumberOfQueues
);
Параметры
[_Out_] RxCapabilities
Указатель на структуру, выделенную драйвером NET_ADAPTER_RX_CAPABILITIES.
[_In_] EvtAdapterReturnRxBuffer
Указатель на функцию обратного вызова EVT_NET_ADAPTER_RETURN_RX_BUFFER драйвера клиента. Дополнительные сведения см. в разделе "Примечания".
[_In_] MaximumFrameSize
Максимальный размер кадра в байтах, который может получить адаптер.
[_In_] MaximumNumberOfQueues
Максимальное количество очередей получения, поддерживаемых адаптером.
Возвращаемое значение
Никакой
Замечания
Эта функция является одной из трех возможных функций для вызова для инициализации структуры NET_ADAPTER_RX_CAPABILITIES. Какой драйвер клиента должен вызывать, зависит от того, как он хотел бы выделить буферы получения и если он хотел бы использовать DMA.
Драйвер клиента должен вызвать NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED, чтобы инициализировать свою структуру NET_ADAPTER_RX_CAPABILITIES, если требуется выполнить выделение буфера вручную и вложение. Вызывая эту функцию, для элемента AllocationMode структуры Rx можно задать значение NetRxFragmentBufferAllocationModeDriver, а для элемента AttachmentMode задано значение NetRxFragmentBufferAttachmentModeDriver. В этом случае он также должен предоставить указатель на функцию обратного вызова EVT_NET_ADAPTER_RETURN_RX_BUFFER в структуре операционной системы, чтобы вызвать после завершения работы системы с буфером получения.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Всеобщий |
| минимальная версия KMDF | 1.25 |
| минимальная версия UMDF | 2.33 |
| заголовка | netadapter.h (include netadaptercx.h) |
| IRQL | PASSIVE_LEVEL |