NDIS_WDI_TX_RELEASE_FRAMES_IND Rückruffunktion (dot11wdi.h)

Artikel
02/26/2024

Wichtig

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

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

Dies ist ein Rückruf innerhalb 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 NdisMiniportDataPathHandle wurde an den IHV-Miniport in MiniportWdiTalTxRxInitialize übergeben.

[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 es auf WDI_TX_MAX_FRAME_COUNT_INVALID (0xFF) festgelegt ist.

[in] Credit

Kredit. Guthaben wird ignoriert, wenn es auf WDI_TX_CREDIT_INVALID (0xFFFF) festgelegt ist.

[out] ppNBL

Zeiger auf einen Zeiger auf eine NET_BUFFER_LIST Kette freigegebener Frames.

Rückgabewert

Keine

Bemerkungen

wenn eine der angegebenen Warteschlangen mit WDI_TX_PAUSE_REASON_PS angehalten wird, gibt die TAL/Target diese Angabe erst aus, wenn sie einen MiniportWdiTxTalQueueInOrder-Hinweis für diese Warteschlange erhalten hat.

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

Der TxMgr gibt möglicherweise eine Liste von NET_BUFFER_LIST zurück, die den Grenzwert der Anzahl von Frames oder Framekosten überschreiten. Dies geschieht nur, wenn die Frames nach dem Senden mit status von Verschoben und mit identischer Sequenznummer erneut abgerufen werden, was angibt, dass sie ursprünglich als Teil einer einzelnen A-MSDU übertragen wurden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10
Unterstützte Mindestversion (Server)	Windows Server 2016
Zielplattform	Windows
Kopfzeile	dot11wdi.h