NET_ADAPTER_TX_CAPABILITIES結構 (netadapter.h)
NET_ADAPTER_TX_CAPABILITIES結構描述 net adapter 的傳輸功能。
語法
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 功能。 如果 MappingRequirement 未設定為 NetMemoryMappingRequirementDmaMapped,NetAdapterCx 會忽略此成員。
UMDF NetAdapterCX 不支援 DmaCapabilities。 UMDF 驅動程式必須將這個成員設定為 NULL。
備註
呼叫其中一個 NET_ADAPTER_TX_CAPABILITIES_INIT_XXX 函式來初始化這個結構。 如需每個初始化函式的詳細資訊,請參閱一節中的連結。
初始化 NET_ADAPTER_TX_CAPABILITIES 結構會當做參數傳遞至 NetAdapterSetDatapathCapabilities。
規格需求
需求 | 值 |
---|---|
最低 KMDF 版本 | 1.27 |
最低UMDF版本 | 2.33 |
標頭 | netadapter.h (包含 netadaptercx.h) |