NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED-Funktion (netadapter.h)

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 Empfangspufferzuweisung 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 "Hinweise".

[_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

Nichts

Bemerkungen

Diese Funktion ist eine von drei möglichen Funktionen, um eine NET_ADAPTER_RX_CAPABILITIES Struktur zu initialisieren. Welcher 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 die manuelle Empfangspufferzuweisung und -anlage ausführen möchte. Durch Aufrufen dieser Funktion wird die AllocationMode Member der Rx-Funktionenstruktur auf NetRxFragmentBufferAllocationModeDriver- festgelegt, und das AttachmentMode Member wird auf NetRxFragmentBufferAttachmentModeDriverfestgelegt. In diesem Fall muss es auch einen Zeiger auf seine EVT_NET_ADAPTER_RETURN_RX_BUFFER Rückruffunktion in der Struktur für das Betriebssystem bereitstellen, um aufzurufen, nachdem das System den Empfangspuffer abgeschlossen hat.

Anforderungen

Siehe auch

NET_ADAPTER_RX_CAPABILITIES

NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED

NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA