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 が NetMemoryMappingRequirementDmaMapped に設定されていない場合、このメンバーは NetAdapterCx によって無視されます。

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