структура NET_ADAPTER_DMA_CAPABILITIES (netadapter.h)
Структура NET_ADAPTER_DMA_CAPABILITIES описывает возможности DMA сетевого адаптера.
Синтаксис
typedef struct _NET_ADAPTER_DMA_CAPABILITIES {
ULONG Size;
WDFDMAENABLER DmaEnabler;
PHYSICAL_ADDRESS MaximumPhysicalAddress;
WDF_TRI_STATE CacheEnabled;
NODE_REQUIREMENT PreferredNode;
} NET_ADAPTER_DMA_CAPABILITIES;
Члены
Size
Размер этой структуры в байтах.
DmaEnabler
Объект включения DMA, используемый драйвером клиента для сопоставления и выделения памяти.
Важно!
При настройке этого объекта со структурой WDF_DMA_ENABLER_CONFIG клиентские драйверы должны задать для члена WdmDmaVersionOverride значение 3 , чтобы указать DMA версии 3.
MaximumPhysicalAddress
Максимальный физический адрес, используемый при выделении буферов памяти. Присвойте этому элементу значение 0 , чтобы указать, что максимальный адрес отсутствует.
CacheEnabled
Значение WDF_TRI_STATE , определяющее, должен ли выделенный объем памяти включать кэш. Если для этого элемента задано значение WdfDefault, кэш будет включен только в том случае, если устройство является согласованным в кэше.
PreferredNode
Предпочтительный узел NUMA, используемый при выделении памяти. Если для этого элемента задано значение MM_ANY_NODE_OK, NetAdapterCx автоматически определит оптимальный узел для использования.
Комментарии
Вызовите NET_ADAPTER_DMA_CAPABILITIES_INIT для инициализации этой структуры.
Эту структуру можно использовать либо в пути получения, в качестве члена структуры NET_ADAPTER_RX_CAPABILITIES , либо в пути передачи в качестве члена структуры NET_ADAPTER_TX_CAPABILITIES .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия KMDF | 1.27 |
| Верхняя часть | netadapter.h (включая netadaptercx.h) |