Freigeben über

NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED-Funktion (netadapter.h)

  • Artikel

Die NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED-Funktion initialisiert eine NET_ADAPTER_RX_CAPABILITIES-Struktur für einen Netzadapter, der die vom Treiber verwaltete Empfangspufferzuordnung und -anlage angeben möchte.

Syntax

void NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED(
  [_Out_] NET_ADAPTER_RX_CAPABILITIES      *RxCapabilities,
  [_In_]  PFN_NET_ADAPTER_RETURN_RX_BUFFER EvtAdapterReturnRxBuffer,
  [_In_]  SIZE_T                           MaximumFrameSize,
  [_In_]  SIZE_T                           MaximumNumberOfQueues
);

Parameter

[_Out_] RxCapabilities

Ein Zeiger auf eine vom Treiber zugewiesene NET_ADAPTER_RX_CAPABILITIES Struktur.

[_In_] EvtAdapterReturnRxBuffer

Ein Zeiger auf die EVT_NET_ADAPTER_RETURN_RX_BUFFER Rückruffunktion des Clienttreibers. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.

[_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_DRIVER_MANAGED aufrufen, um seine NET_ADAPTER_RX_CAPABILITIES Struktur zu initialisieren, wenn er eine manuelle Empfangspufferzuordnung und -anlage durchführen möchte. Durch Aufrufen dieser Funktion wird der AllocationMode-Member der Rx-Funktionenstruktur auf NetRxFragmentBufferAllocationModeDriver festgelegt, und das AttachmentMode-Element ist auf NetRxFragmentBufferAttachmentModeDriver festgelegt. In diesem Fall muss es auch einen Zeiger auf seine EVT_NET_ADAPTER_RETURN_RX_BUFFER Rückruffunktion in der Struktur bereitstellen, damit das Betriebssystem aufrufen kann, sobald das System den Empfangspuffer abgeschlossen hat.

Anforderungen

Anforderung Wert
Zielplattform Universell
KMDF-Mindestversion 1,25
UMDF-Mindestversion 2.33
Kopfzeile netadapter.h (include netadaptercx.h)
IRQL PASSIVE_LEVEL

Weitere Informationen

NET_ADAPTER_RX_CAPABILITIES

NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED

NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA