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