структура 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 не задано значение NetMemoryMappingRequirementDmaMapped.

UMDF NetAdapterCX не поддерживает DmaCapabilities. Драйверы UMDF должны задать для этого элемента значение NULL.

Комментарии

Вызовите одну из функций NET_ADAPTER_TX_CAPABILITIES_INIT_XXX для инициализации этой структуры. Дополнительные сведения о каждой функции инициализации см. по ссылкам в разделе См. также.

Инициализированная структура NET_ADAPTER_TX_CAPABILITIES передается в качестве параметра в NetAdapterSetDatapathCapabilities.

Требования

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

NET_ADAPTER_TX_CAPABILITIES_INIT

NET_ADAPTER_TX_CAPABILITIES_INIT_FOR_DMA