NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA-Funktion (netadapter.h)

Artikel
03/05/2024

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

Syntax

void NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA(
  [_Out_] NET_ADAPTER_RX_CAPABILITIES  *RxCapabilities,
  [_In_]  NET_ADAPTER_DMA_CAPABILITIES *DmaCapabilities,
  [_In_]  SIZE_T                       MaximumFrameSize,
  [_In_]  SIZE_T                       MaximumNumberOfQueues
);

Parameter

[_Out_] RxCapabilities

Ein Zeiger auf eine vom Treiber zugewiesene NET_ADAPTER_RX_CAPABILITIES-Struktur .

[_In_] DmaCapabilities

Ein Zeiger auf eine vom Treiber zugewiesene und initialisierte NET_ADAPTER_DMA_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_DMA aufrufen, um seine NET_ADAPTER_RX_CAPABILITIES-Struktur zu initialisieren, wenn das Betriebssystem die Empfangspufferzuordnung und -anlage durchführen und DMA auch in seinem Empfangsdatenpfad verwenden möchte. Durch Aufrufen dieser Funktion wird der AllocationMode-Member der Rx-Funktionsstruktur auf NetRxFragmentBufferAllocationModeSystem und das AttachmentMode-Element auf NetRxFragmentBufferAttachmentModeSystem festgelegt.

Vor dem Aufrufen NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA muss der Treiber eine NET_ADAPTER_DMA_CAPABILITIES-Struktur zugeordnet und mit NET_ADAPTER_DMA_CAPABILITIES_INIT initialisiert haben. Diese DMA-Funktionsstruktur wird dann dem DmaCapabilities-Member der NET_ADAPTER_RX_CAPABILITIES-Struktur zugewiesen.