NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED-Funktion (netadapter.h)

Artikel
05/23/2024

Die NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED-Funktion initialisiert eine NET_ADAPTER_RX_CAPABILITIES-Struktur für einen Netzadapter, der die vom Betriebssystem verwaltete Empfangspufferzuordnung und -anlage angeben möchte, aber nicht die Verwendung der DMA-Speicherzuordnung.

Syntax

void NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED(
  [_Out_] NET_ADAPTER_RX_CAPABILITIES *RxCapabilities,
  [_In_]  SIZE_T                      MaximumFrameSize,
  [_In_]  SIZE_T                      MaximumNumberOfQueues
);

Parameter

[_Out_] RxCapabilities

Ein Zeiger auf eine vom Treiber zugewiesene NET_ADAPTER_RX_CAPABILITIES-Struktur .

[_In_] MaximumFrameSize

Die maximale Framegröße in Bytes, die der Adapter empfangen kann.

[_In_] MaximumNumberOfQueues

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

Rückgabewert

Keine

Bemerkungen

Diese Funktion ist eine von drei möglichen Funktionen, die aufgerufen werden können, um eine NET_ADAPTER_RX_CAPABILITIES-Struktur zu initialisieren. Welche Vom Clienttreiber aufgerufen werden soll, hängt davon ab, wie er Empfangspuffer zuordnen möchte und ob er DMA verwenden möchte.

Der Clienttreiber muss NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED aufrufen, um seine NET_ADAPTER_RX_CAPABILITIES-Struktur zu initialisieren, wenn das Betriebssystem die Empfangspufferzuordnung und -anlage durchführen soll, aber keine DMA-Speicherzuordnung erfordert. Durch Aufrufen dieser Funktion wird der AllocationMode-Member der Rx-Funktionsstruktur auf NetRxFragmentBufferAllocationModeSystem und das AttachmentMode-Element auf NetRxFragmentBufferAttachmentModeSystem festgelegt. Da der Treiber in diesem Fall keine DMA-Funktionen angibt, legt diese Funktion auch das MappingRequirement-Element auf NetMemoryMappingRequirementNone fest.