NDIS_RSC_NBL_INFO union (ndis/nblrsc.h)

發行項
02/29/2024

NDIS_RSC_NBL_INFO等位會指定與NET_BUFFER_LIST結構相關聯的 (RSC) 計數器資訊來聯合區段。

語法

typedef union _NDIS_RSC_NBL_INFO {
  struct {
    USHORT CoalescedSegCount;
    USHORT DupAckCount;
  } Info;
  PVOID  Value;
} NDIS_RSC_NBL_INFO, *PNDIS_RSC_NBL_INFO;

成員

Info

包含在 NDIS_RSC_NBL_INFO 中的等位成員。驅動程式會使用資訊來存取 RSC 資訊。 Info 是具有下列成員的結構：

Info.CoalescedSegCount

NET_BUFFER_LIST 結構中的聯合區段數目。對於非 RSC 封包，此成員必須設定為零。驅動程式可以使用 NET_BUFFER_LIST_COALESCED_SEG_COUNT 宏來存取此成員。

注意只有在 CoalescedSegCount 不是零時，RscTcpTimestampDelta 資訊和 DupAckCount 成員才應該是非零。如需 RscTcpTimestampDelta 的詳細資訊，請參閱一節。

Info.DupAckCount

形成 NET_BUFFER_LIST 結構時遇到的重複 ACK 數目。只有在 CoalescedSegCount 不是零時，DupAckCount 才應該是非零。驅動程式可以使用 NET_BUFFER_LIST_DUP_ACK_COUNT 宏來存取此成員。

Value

包含在 NDIS_RSC_NBL_INFO 中的等位成員。驅動程式會使用 Value 來存取 RSC 資訊作為單一 PVOID。

備註

若要存取與NET_BUFFER_LIST結構相關聯的接收區段聯合 (RSC) 計數器資訊，NDIS 驅動程式會呼叫 NET_BUFFER_LIST_INFO 宏，並指定NDIS_RSC_NBL_INFO等位中的 TcpRecvSegCoalesceInfo 信息類型。

若要存取與NET_BUFFER_LIST結構相關聯的 RSC 時間戳資訊，NDIS 驅動程式會呼叫 NET_BUFFER_LIST_INFO 宏，並指定單一 ULONG 值的 RscTcpTimestampDelta 資訊類型。

注意只有當 CoalescedSegCount 不是零時，rscTcpTimestampDelta 資訊和 NDIS_RSC_NBL_INFO的 DupAckCount 成員才應該是非零。

針對使用 TCP 時間戳選項的聯合區段，可能會設定 RscTcpTimestampDelta 資訊。 RscTcpTimestampDelta 資訊應該包含聯合區段中最早和最新 TCP 時間戳值之間的差異。迷你埠驅動程式可以提供 RscTcpTimestampDelta 的 16 位值。

單一聯合單位 (SCU) 的 NET_BUFFER_LIST結構與沒有 RSC 之接收路徑上指示的標準 NET_BUFFER_LIST 結構不同。 SCU 類似於來自網路的IP jumbogram 封包。因此，每個指定的SCU都必須為每個 NET_BUFFER_LIST 有一個 NET_BUFFER結構。

NET_BUFFER可以是 MDL 鏈結，且 MDL 的大小總計可超過標準最大傳輸單位 (MTU) ，但必須受到法律 IP 數據報長度上限的限制，請參閱 RFC791 第 3.1 節。

此外，也可以為 SCU 提供額外的 NET_BUFFER_LIST 資訊。 NDIS 會執行 NET_BUFFER_LIST 和 NET_BUFFER 驗證。主機 TCPIP 堆疊會執行封包檢查，包括 IP 和 TCP 標頭驗證。