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をするパラメーターとして渡されます。
必要条件
| 要件 | 価値 |
|---|---|
| 最小 KMDF バージョン | 1.27 |
| UMDF の最小バージョン を する | 2.33 |
| ヘッダー | netadapter.h (netadaptercx.h を含む) |