NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED-Funktion (netadapter.h)
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 Empfangspufferzuweisung und -anlage, aber nicht die Verwendung der DMA-Speicherzuordnung angeben möchte.
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
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_SYSTEM_MANAGED aufrufen, um seine NET_ADAPTER_RX_CAPABILITIES-Struktur zu initialisieren, wenn das Betriebssystem die Pufferzuweisung und -anlage ausführen soll, jedoch keine DMA-Speicherzuordnung erfordert. Durch Aufrufen dieser Funktion wird das AllocationMode-Element der Rx-Funktionenstruktur auf NetRxFragmentBufferAllocationModeSystem festgelegt, und das AttachmentMode Member wird auf NetRxFragmentBufferAttachmentModeSystemfestgelegt. Da der Treiber in diesem Fall keine DMA-Funktionen angibt, legt diese Funktion auch die MappingRequirement Member auf NetMemoryMappingRequirementNonefest.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Minimale KMDF-Version | 1.25 |
| Mindest-UMDF-Version | 2.33 |
| Header- | netadapter.h (include netadaptercx.h) |