структура NET_ADAPTER_TX_CAPABILITIES (netadapter.h)
Структура NET_ADAPTER_TX_CAPABILITIES описывает возможности передачи сетевого адаптера.
Синтаксис
typedef struct _NET_ADAPTER_TX_CAPABILITIES {
ULONG Size;
NET_MEMORY_MAPPING_REQUIREMENT MappingRequirement;
SIZE_T PayloadBackfill;
SIZE_T MaximumNumberOfFragments;
SIZE_T FragmentBufferAlignment;
UINT32 FragmentRingNumberOfElementsHint;
SIZE_T MaximumNumberOfQueues;
NET_ADAPTER_DMA_CAPABILITIES *DmaCapabilities;
} NET_ADAPTER_TX_CAPABILITIES;
Члены
Size
Размер этой структуры в байтах.
MappingRequirement
Значение NET_MEMORY_MAPPING_REQUIREMENT, указывающее, как операционная система должна сопоставлять буферы данных.
Драйверы UMDF должны задать MappingRequirement значение NetMemoryMappingRequirementNone.
PayloadBackfill
Объем пространства в байтах, зарезервированный для драйвера клиента перед началом каждой полезных данных NET_PACKET.
MaximumNumberOfFragments
Максимальное количество фрагментов для каждого пакета, которое может обрабатывать адаптер, или ((SIZE_T) - 1), если ограничения отсутствуют.
FragmentBufferAlignment
Минимальное выравнивание фрагментов пакетов. Этот член должен быть мощностью 2.
FragmentRingNumberOfElementsHint
Указание, указывающее, сколько элементов адаптера требуется для каждого NET_FRAGMENT кольцевого буфера очереди передачи. Этот член должен быть мощностью 2.
MaximumNumberOfQueues
Максимальное количество очередей передачи, поддерживаемых адаптером.
DmaCapabilities
Указатель на выделенную драйвером и инициализированную NET_DMA_CAPABILITIES структуру, описывающую возможности DMA адаптера на пути передачи. Этот элемент игнорируется NetAdapterCx, если MappingRequirement не задано значение NetMemoryMappingRequirementDmapped.
UMDF NetAdapterCX не поддерживает DmaCapabilities. Драйверы UMDF должны задать для этого члена значение NULL.
Замечания
Вызовите одну из функций NET_ADAPTER_TX_CAPABILITIES_INIT_XXX для инициализации этой структуры. Дополнительные сведения о каждой функции инициализации см. в разделе "См. также".
Инициализированная структура NET_ADAPTER_TX_CAPABILITIES передается в качестве параметра NetAdapterSetDatapathCapabilities.
Требования
| Требование | Ценность |
|---|---|
| минимальная версия KMDF | 1.27 |
| минимальная версия UMDF | 2.33 |
| заголовка | netadapter.h (include netadaptercx.h) |