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 功能。 如果 MappingRequirement 未設定為 netMemoryMappingRequirementDmapped ,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) |