NET_ADAPTER_TX_CAPABILITIES_INIT_FOR_DMA-Funktion (netadapter.h)

  • Artikel

Die NET_ADAPTER_TX_CAPABILITIES_INIT_FOR_DMA-Funktion initialisiert eine NET_ADAPTER_TX_CAPABILITIES-Struktur für einen Netzadapter, der die Verwendung von DMA in seinem Übertragungsdatenpfad angegeben hat.

Syntax

void NET_ADAPTER_TX_CAPABILITIES_INIT_FOR_DMA(
  [_Out_] NET_ADAPTER_TX_CAPABILITIES  *TxCapabilities,
  [_In_]  NET_ADAPTER_DMA_CAPABILITIES *DmaCapabilities,
  [_In_]  SIZE_T                       MaximumNumberOfQueues
);

Parameter

[_Out_] TxCapabilities

Ein Zeiger auf eine vom Treiber zugewiesene NET_ADAPTER_TX_CAPABILITIES Struktur.

[_In_] DmaCapabilities

Ein Zeiger auf eine vom Treiber zugewiesene und initialisierte NET_ADAPTER_DMA_CAPABILITIES-Struktur .

[_In_] MaximumNumberOfQueues

Die maximale Anzahl von Übertragungswarteschlangen, die der Adapter unterstützt.

Rückgabewert

Keine

Bemerkungen

Diese Funktion ist eine von zwei möglichen Funktionen, die aufgerufen werden können, um eine NET_ADAPTER_TX_CAPABILITIES-Struktur zu initialisieren. Welche vom Clienttreiber aufgerufen werden soll, hängt davon ab, ob er DMA verwenden möchte. NET_ADAPTER_TX_CAPABILITIES_INIT wird verwendet, wenn der Treiber keine DMA-Speicherzuordnung für seine Übertragungspuffer angibt, und wenn dies der Fall ist, wird NET_ADAPTER_TX_CAPABILITIES_INIT_FOR_DMA verwendet.

Vor dem Aufrufen von NET_ADAPTER_TX_CAPABILITIES_INIT_FOR_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_TX_CAPABILITIES-Struktur zugewiesen.

Anforderungen

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

Weitere Informationen

NET_ADAPTER_TX_CAPABILITIES

NET_ADAPTER_TX_CAPABILITIES_INIT