NET_ADAPTER_TX_CAPABILITIES-Struktur (netadapter.h)
Die NET_ADAPTER_TX_CAPABILITIES-Struktur beschreibt die Übertragungsfunktionen eines Netzadapters.
Syntax
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;
Member
Size
Die Größe dieser Struktur in Bytes.
MappingRequirement
Ein NET_MEMORY_MAPPING_REQUIREMENT Wert, der angibt, wie das Betriebssystem Übertragungsdatenpuffer zuordnen soll.
UMDF-Treiber müssen MappingRequirement auf NetMemoryMappingRequirementNone festlegen.
PayloadBackfill
Die Menge des Speicherplatzes in Bytes, der vor dem Start der Nutzlast jedes NET_PACKET für den Clienttreiber reserviert ist.
MaximumNumberOfFragments
Die maximale Anzahl von Fragmenten pro Paket, die der Adapter verarbeiten kann, oder ((SIZE_T) - 1) wenn es kein Limit gibt.
FragmentBufferAlignment
Die minimale Ausrichtung für Paketfragmente. Dieses Element muss eine Stärke von 2 sein.
FragmentRingNumberOfElementsHint
Ein Hinweis, der angibt, wie viele Elemente der Adapter für die NET_FRAGMENT Ringpuffer jeder Übertragungswarteschlange benötigt. Dieses Element muss eine Stärke von 2 sein.
MaximumNumberOfQueues
Die maximale Anzahl von Übertragungswarteschlangen, die der Adapter unterstützt.
DmaCapabilities
Ein Zeiger auf eine vom Treiber zugewiesene und initialisierte NET_DMA_CAPABILITIES Struktur, die die DMA-Funktionen des Adapters im Übertragungspfad beschreibt. Dieses Element wird von NetAdapterCx ignoriert, wenn MappingRequirement nicht auf NetMemoryMappingRequirementDmaMapped festgelegt ist.
UMDF NetAdapterCX unterstützt DmaCapabilities nicht. UMDF-Treiber müssen diesen Member auf NULL festlegen.
Hinweise
Rufen Sie eine der NET_ADAPTER_TX_CAPABILITIES_INIT_XXX-Funktionen auf, um diese Struktur zu initialisieren. Weitere Informationen zu den einzelnen Initialisierungsfunktionen finden Sie unter den Links im Abschnitt Siehe auch.
Eine initialisierte NET_ADAPTER_TX_CAPABILITIES Struktur wird als Parameter an NetAdapterSetDatapathCapabilities übergeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| KMDF-Mindestversion | 1,27 |
| UMDF-Mindestversion | 2.33 |
| Kopfzeile | netadapter.h (include netadaptercx.h) |