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)

另請參閱

NET_ADAPTER_TX_CAPABILITIES_INIT

NET_ADAPTER_TX_CAPABILITIES_INIT_FOR_DMA