NET_ADAPTER_RX_CAPABILITIES-Struktur (netadapter.h)

Artikel
05/23/2024

Die NET_ADAPTER_RX_CAPABILITIES-Struktur beschreibt die Empfangsfunktionen eines Netzadapters.

Syntax

typedef struct _NET_ADAPTER_RX_CAPABILITIES {
  ULONG                                  Size;
  NET_RX_FRAGMENT_BUFFER_ALLOCATION_MODE AllocationMode;
  NET_RX_FRAGMENT_BUFFER_ATTACHMENT_MODE AttachmentMode;
  UINT32                                 FragmentRingNumberOfElementsHint;
  SIZE_T                                 MaximumFrameSize;
  SIZE_T                                 MaximumNumberOfQueues;
  union {
    struct {
      PFN_NET_ADAPTER_RETURN_RX_BUFFER EvtAdapterReturnRxBuffer;
    } DUMMYSTRUCTNAME;
    struct {
      NET_MEMORY_MAPPING_REQUIREMENT MappingRequirement;
      SIZE_T                         FragmentBufferAlignment;
      NET_ADAPTER_DMA_CAPABILITIES   *DmaCapabilities;
    } DUMMYSTRUCTNAME2;
  } DUMMYUNIONNAME;
} NET_ADAPTER_RX_CAPABILITIES;

Member

Size

Die Größe dieser Struktur in Bytes.

AllocationMode

Ein NET_RX_FRAGMENT_BUFFER_ALLOCATION_MODE Wert, der angibt, wie das Betriebssystem Empfangspuffer zuordnen soll.

UMDF-Treiber müssen diesen Wert auf NetRxFragmentBufferAllocationModeSystem festlegen.

AttachmentMode

Ein NET_RX_FRAGMENT_BUFFER_ATTACHMENT_MODE Wert, der angibt, wie das Betriebssystem Empfangspuffer vorab anfügen soll.

UMDF-Treiber müssen diesen Wert auf NetRxFragmentBufferAttachmentModeSystem festlegen.

FragmentRingNumberOfElementsHint

Ein Hinweis, der angibt, wie viele Elemente der Adapter für den Ringpuffer jeder Empfangswarteschlange NET_FRAGMENTbenötigt. Dieses Element muss eine Stärke von 2 sein.

MaximumFrameSize

Die maximale Framegröße in Bytes, die der Adapter empfangen kann. Dieser Wert sollte die maximale MTU-Größe (Transmission Unit) enthalten, die Ihre Hardware für ein IP-Paket unterstützt, sowie zusätzlichen Speicherplatz, den Ihr Treiber möglicherweise für Paketmetadaten benötigt. Weitere Informationen finden Sie im Empfangsbeispiel im Abschnitt Hinweise von EVT_PACKET_QUEUE_ADVANCE.

MaximumNumberOfQueues

Die maximale Anzahl von Empfangswarteschlangen, die der Adapter unterstützt.

DUMMYUNIONNAME

Eine Union, die die folgenden Elemente enthält:

DUMMYUNIONNAME.DUMMYSTRUCTNAME

Eine Struktur, die das folgende Element enthält:

DUMMYUNIONNAME.DUMMYSTRUCTNAME.EvtAdapterReturnRxBuffer

Ein Zeiger auf die EVT_NET_ADAPTER_RETURN_RX_BUFFER Rückruffunktion des Treibers. Dieser Member ist erforderlich, wenn das AllocationMode-Element auf NetRxFragmentBufferAllocationModeDriver festgelegt ist, damit das Betriebssystem aufrufen kann, sobald das System mit dem Empfangspuffer abgeschlossen ist.

DUMMYUNIONNAME.DUMMYSTRUCTNAME2

Eine Struktur, die die folgenden Elemente enthält:

DUMMYUNIONNAME.DUMMYSTRUCTNAME2.MappingRequirement

Ein NET_MEMORY_MAPPING_REQUIREMENT Wert, der angibt, wie das Betriebssystem Empfangsdatenpuffer zuordnen soll.

UMDF-Treiber müssen MappingRequirement auf NetMemoryMappingRequirementNone festlegen.

DUMMYUNIONNAME.DUMMYSTRUCTNAME2.FragmentBufferAlignment

Die minimale Ausrichtung für Paketfragmente. Dieses Element muss eine Stärke von 2 sein.

DUMMYUNIONNAME.DUMMYSTRUCTNAME2.DmaCapabilities

Ein Zeiger auf eine vom Treiber zugewiesene und initialisierte NET_DMA_CAPABILITIES Struktur, die die DMA-Funktionen des Adapters im Empfangspfad 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_RX_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_RX_CAPABILITIES Struktur wird als Parameter an NetAdapterSetDatapathCapabilities übergeben.

In der Regel führt ein Clienttreiber entweder die Zuordnung und die Anlage selbst aus oder gibt an, dass das Betriebssystem beides ausführt. In den meisten Fällen wird empfohlen, dass das Betriebssystem Empfangspuffer zuordnet und anfügt.

Wenn der Client treiberseitig zugeordnete und angefügte Empfangspuffer angibt, muss er sowohl eine benutzerdefinierte Rückgabekontextstruktur im RxBufferReturnContext-Member jedes NET_FRAGMENT während der Pufferzuordnung als auch eine EVT_NET_ADAPTER_RETURN_RX_BUFFER Rückruffunktion in dieser NET_ADAPTER_RX_CAPABILITIES Struktur bereitstellen, damit das Betriebssystem aufrufen kann, sobald es mit dem Puffer fertig ist.