TCP_ESTATS_BANDWIDTH_RW_v0 結構 (tcpestats.h)

發行項
08/26/2023

TCP_ESTATS_BANDWIDTH_RW_v0結構包含 TCP 連線頻寬估計延伸 TCP 統計資料的讀取/寫入組態資訊。

語法

typedef struct _TCP_ESTATS_BANDWIDTH_RW_v0 {
  TCP_BOOLEAN_OPTIONAL EnableCollectionOutbound;
  TCP_BOOLEAN_OPTIONAL EnableCollectionInbound;
} TCP_ESTATS_BANDWIDTH_RW_v0, *PTCP_ESTATS_BANDWIDTH_RW_v0;

成員

EnableCollectionOutbound

值，指出是否應該收集 TCP 連線上的擴充統計資料，以進行輸出頻寬估計。

如果此成員設定為 TcpBoolOptEnabled，則會啟用輸出頻寬估計之 TCP 連線的擴充統計資料。如果此成員設定為 TcpBoolOptDisabled，則會停用 TCP 連線上輸出頻寬估計的擴充統計資料。如果此成員設定為 TcpBoolOptUnchanged，輸出頻寬估計的 TCP 連線擴充統計資料會保持不變。

未設定時，此成員的預設狀態為停用。

EnableCollectionInbound

值，指出是否應該收集 TCP 連線上的擴充統計資料，以進行輸入頻寬估計。

如果此成員設定為 TcpBoolOptEnabled，則會啟用輸入頻寬估計之 TCP 連線的擴充統計資料。如果此成員設定為 TcpBoolOptDisabled，則會停用輸入頻寬估計之 TCP 連線的擴充統計資料。如果此成員設定為 TcpBoolOptUnchanged，則輸入頻寬估計 TCP 連線的擴充統計資料不會變更。

未設定時，此成員的預設狀態為停用。

備註

TCP_ESTATS_BANDWIDTH_RW_v0結構是 Windows Vista 和更新版本上可用的 TCP 擴充統計資料功能的一部分。

TCP_ESTATS_BANDWIDTH_RW_v0定義為結構第 0 版，以取得 TCP 連線頻寬估計的讀取/寫入組態資訊。

當TcpConnectionEstatsBandwidth在EstatsType參數中傳遞 TcpConnectionEstatsBandwidth 時，會使用此結構和SetPerTcp6ConnectionEStats 和 SetPerTcpConnectionEStats函式來啟用和停用 TCP 連線的擴充 TCP 統計資料。

傳遞至SetPerTcp6ConnectionEStats和SetPerTcpConnectionEStats 函式的Offset參數目前未使用，且必須設定為 0。因此，當 EstatsType參數設定為TcpConnectionEstatsBandwidth時，Rw參數所指向的TCP_ESTATS_BANDWIDTH_RW_v0結構成員必須同時擁有EnableCollectionOutbound和EnableCollectionInbound結構成員設定為SetPerTcp6ConnectionEStats和SetPerTcpConnectionEStats函式中的慣用值。

在EstatsType參數中傳遞TcpConnectionEstatsBandwidth時，會透過呼叫GetPerTcp6ConnectionEStats或GetPerTcpConnectionEStats函式來擷取TCP_ESTATS_BANDWIDTH_RW_v0結構。

規格需求


最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
標頭	tcpestats.h