NDIS_WDI_TX_RELEASE_FRAMES_IND Rückruffunktion (dot11wdi.h)

Artikel
02/06/2025

Wichtig

Dieses Thema ist Teil des in Windows 10 veröffentlichten WDI-Treiber modells. Das WDI-Treibermodell befindet sich im Wartungsmodus und erhält nur Korrekturen mit hoher Priorität. WiFiCx- ist das in Windows 11 veröffentlichte Wi-Fi Treibermodell. Es wird empfohlen, wiFiCx zu verwenden, um die neuesten Features nutzen zu können.

Die Rückruffunktion NdisWdiTxReleaseFrameIndication gibt bis zu einer bestimmten Anzahl oder Aggregatkosten von Frames in die Warteschlange einer bestimmten Peer-TID-Kombination zurück, wenn die Übertragung angehalten wird. Wenn die angegebenen Warteschlangen nicht angehalten werden, werden keine der NET_BUFFER_LISTs freigegeben.

Dies ist ein Rückruf in NDIS_WDI_DATA_API.

Syntax

NDIS_WDI_TX_RELEASE_FRAMES_IND NdisWdiTxReleaseFramesInd;

void NdisWdiTxReleaseFramesInd(
  [in]  NDIS_HANDLE NdisMiniportDataPathHandle,
  [in]  WDI_PORT_ID PortId,
  [in]  WDI_PEER_ID PeerId,
  [in]  UINT32 ExTidBitmask,
  [in]  UINT8 MaxNumFrames,
  [in]  UINT16 Credit,
  [out] PNET_BUFFER_LIST *ppNBL
)
{...}

Parameter

[in] NdisMiniportDataPathHandle

Der an den IHV-Miniport übergebene NdisMiniportDataPathHandle in MiniportWdiTalTxRxInitialize.

[in] PortId

Die Port-ID. Muss ein Nicht-Wildcard-Wert sein.

[in] PeerId

Die Peer-ID. Muss ein Nicht-Wildcard-Wert sein.

[in] ExTidBitmask

Die erweiterte TID-Bitmaske.

[in] MaxNumFrames

Maximale Frameanzahl. MaxNumFrames wird ignoriert, wenn sie auf WDI_TX_MAX_FRAME_COUNT_INVALID (0xFF) festgelegt ist.

[in] Credit

Kredit. Credit wird ignoriert, wenn sie auf WDI_TX_CREDIT_INVALID (0xFFFF) festgelegt ist.

[out] ppNBL

Zeiger auf einen Zeiger auf eine NET_BUFFER_LIST Kette freigegebener Frames.

Rückgabewert

Nichts

Bemerkungen

Wenn eine der angegebenen Warteschlangen mit WDI_TX_PAUSE_REASON_PSangehalten wird, gibt das TAL/Target diese Angabe erst aus, wenn sie eine MiniportWdiTxTalQueueInOrder Indikation für diese Warteschlange erhalten hat.

Diese Angabe ist nur zulässig, wenn TargetPriorityQueueing "false" ist.

Das TxMgr kann eine Liste von NET_BUFFER_LIST zurückgeben, die den Grenzwert der Anzahl der Frames oder Framekosten überschreiten. Dies geschieht nur, wenn die Frames nach dem Senden mit dem Status "Verschoben" und mit identischer Sequenznummer erneut abgefragt werden, was angibt, dass sie ursprünglich als Teil eines einzelnen A-MSDU übertragen wurden.