estrutura TCP_ESTATS_BANDWIDTH_RW_v0 (tcpestats.h)

Artigo
08/26/2023

A estrutura TCP_ESTATS_BANDWIDTH_RW_v0 contém informações de configuração de leitura/gravação para estatísticas TCP estendidas sobre a estimativa de largura de banda para uma conexão TCP.

Sintaxe

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;

Membros

EnableCollectionOutbound

Um valor que indica se estatísticas estendidas em uma conexão TCP devem ser coletadas para estimativa de largura de banda de saída.

Se esse membro estiver definido como TcpBoolOptEnabled, as estatísticas estendidas na conexão TCP para estimativa de largura de banda de saída serão habilitadas. Se esse membro estiver definido como TcpBoolOptDisabled, as estatísticas estendidas na conexão TCP para estimativa de largura de banda de saída serão desabilitadas. Se esse membro estiver definido como TcpBoolOptUnchanged, as estatísticas estendidas na conexão TCP para estimativa de largura de banda de saída ficarão inalteradas.

O estado padrão desse membro quando não definido está desabilitado.

EnableCollectionInbound

Um valor que indica se as estatísticas estendidas em uma conexão TCP devem ser coletadas para estimativa de largura de banda de entrada.

Se esse membro estiver definido como TcpBoolOptEnabled, as estatísticas estendidas na conexão TCP para estimativa de largura de banda de entrada serão habilitadas. Se esse membro estiver definido como TcpBoolOptDisabled, as estatísticas estendidas na conexão TCP para estimativa de largura de banda de entrada serão desabilitadas. Se esse membro estiver definido como TcpBoolOptUnchanged, as estatísticas estendidas na conexão TCP para estimativa de largura de banda de entrada ficarão inalteradas.

O estado padrão desse membro quando não definido está desabilitado.

Comentários

A estrutura de TCP_ESTATS_BANDWIDTH_RW_v0 é usada como parte do recurso de estatísticas estendidas TCP disponível no Windows Vista e posterior.

O TCP_ESTATS_BANDWIDTH_RW_v0 é definido como a versão 0 da estrutura para obter informações de configuração de leitura/gravação na estimativa de largura de banda para uma conexão TCP.

As estatísticas de TCP estendidas sobre a estimativa de largura de banda para uma conexão TCP são habilitadas e desabilitadas usando essa estrutura e as funções SetPerTcp6ConnectionEStats e SetPerTcpConnectionEStats quando TcpConnectionEstatsBandwidth é passada no parâmetro EstatsType .

O parâmetro Offset passado para as funções SetPerTcp6ConnectionEStats e SetPerTcpConnectionEStats não é usado no momento e deve ser definido como 0. Consequentemente, a estrutura TCP_ESTATS_BANDWIDTH_RW_v0 apontada pelo parâmetro Rw quando o parâmetro EstatsType é definido como TcpConnectionEstatsBandwidth deve ter os membros da estrutura EnableCollectionOutbound e EnableCollectionInbound definidos como os valores preferenciais em uma única chamada para as funções SetPerTcp6ConnectionEStats e SetPerTcpConnectionEStats .

A estrutura TCP_ESTATS_BANDWIDTH_RW_v0 é recuperada por chamadas para as funções GetPerTcp6ConnectionEStats ou GetPerTcpConnectionEStats quando TcpConnectionEstatsBandwidth é passado no parâmetro EstatsType .

Requisitos


Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho	tcpestats.h