Função QOSSetFlow (qos2.h)

A função QOSSetFlow é chamada por um aplicativo para solicitar que o subsistema QOS priorize os pacotes do aplicativo e altere o tráfego de fluxo. Essa função também é usada para notificar o subsistema QoS de uma alteração de fluxo: por exemplo, se a taxa de fluxo for alterada para considerar o congestionamento de rede ou se o valor de prioridade do QoS exigir ajuste para transferir ou transmitir diferentes tipos de conteúdo em uma única conexão de soquete persistente.

Sintaxe

ExternC BOOL QOSSetFlow(
  [in]            HANDLE       QOSHandle,
  [in]            QOS_FLOWID   FlowId,
  [in]            QOS_SET_FLOW Operation,
  [in]            ULONG        Size,
  [in]            PVOID        Buffer,
                  DWORD        Flags,
  [out, optional] LPOVERLAPPED Overlapped
);

Parâmetros

[in] QOSHandle

Manipule para o subsistema QOS retornado por QOSCreateHandle.

[in] FlowId

Um identificador de fluxo. Um QOS_FLOWID é um inteiro sem sinal de 32 bits.

[in] Operation

Um QOS_SET_FLOW tipo enumerado que identifica o que será alterado no fluxo. Esse parâmetro especifica qual estrutura o Buffer conterá.

[in] Size

O tamanho do parâmetro Buffer , em bytes.

[in] Buffer

Ponteiro para a estrutura especificada pelo valor do parâmetro Operation .

Flags

Reservado para uso futuro. Esse parâmetro deve ser definido como 0.

[out, optional] Overlapped

Ponteiro para uma estrutura OVERLAPPED usada para saída assíncrona. Isso deverá ser definido como NULL se essa função não estiver sendo chamada de forma assíncrona.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será 0. Para obter informações de erro estendidas, chame GetLastError. Alguns códigos de erro possíveis seguem.

Comentários

Se QOSStartTrackingClient ainda não tiver sido chamado, chamar QOSSetFlow fará com que o subsistema QOS execute o seguinte.

• Descubra se o caminho de rede de ponta a ponta dá suporte à priorização.
• Acompanhe as características de rede de ponta a ponta por meio de experimentos de rede. Esses experimentos não colocam nenhum estresse notável na rede.

Se QOSSetFlow retornar ERROR_NETWORK_BUSY não haverá largura de banda suficiente para a taxa de fluxo especificada e a prioridade de rede não poderá ser concedida. O aplicativo ainda pode transmitir um fluxo de dados, mas o fluxo não receberá a marcação de prioridade. O ideal é que um aplicativo não tente transmitir na taxa solicitada se não houver largura de banda suficiente. Se ERROR_NETWORK_BUSY for retornado, a seguinte estratégia segura estará disponível:

1. Consulte o subsistema QoS com QOSNotifyFlow para determinar a largura de banda disponível atual e comece a transmitir na taxa mais baixa recebida com prioridade se a rede der suporte a ele.
2. Solicite notificação com QOSNotifyFlow para quando a quantidade de largura de banda originalmente desejada estiver disponível. Quando a notificação for recebida, chame QOSSetFlow com a nova solicitação de largura de banda e envie à nova taxa novamente com priorização, se houver suporte.

Opcionalmente, essa função pode ser chamada de forma assíncrona.

Exemplos

O snippet de código a seguir demonstra o uso de QOSSetFlow em um aplicativo. Os parâmetros de entrada QOSHandle, FlowId, FlowId, QOSSetOutgoingRate e sizeof(QoSOutgoingFlowrate) devem ser inicializados anteriormente por outras funções e cálculos de QoS dentro do aplicativo.

Outros exemplos de função de QoS que mostram a inicialização de parâmetros incluem QOSCreateHandle, QOSAddSocketToFlow e QOSQueryFlow.

Consulte o SDK do Windows para obter uma listagem de código de exemplo completa. Pasta do SDK: Samples\NetDs\GQos\Qos2

if( QOSSetFlow( QOSHandle,
        FlowId,
        QOSSetOutgoingRate,           // Operation 
        sizeof(QoSOutgoingFlowrate),  // Size
        &QoSOutgoingFlowrate,         // Buffer
        0,                            // Flags (Must be set to 0 with QoS Version 1.0)
        NULL)                         // Overlapped
        == 0 )
{
    if( ERROR_INVALID_PARAMETER == GetLastError())
    {
        std::cerr << __FILE__ <<" Line: " << __LINE__ ;
        std::cerr << " - QOSSetFlow failed. Exception code: "; 
        std::cerr << GetLastError() << " - Invalid parameter"; 
        std::cerr << std::endl;
    }
    else
    {
        std::cerr << __FILE__ <<" Line: " << __LINE__ ;
        std::cerr << " - QOSSetFlow failed. Exception code: "; 
        std::cerr << GetLastError() << std::endl;
    }
    
}
else
{
    std::cout << "QOSSetFlow set outgoing flowrate bandwidth to "; 
    std::cout << QoSOutgoingFlowrate.Bandwidth;
    std::cerr << std::endl;
}

Requisitos

Confira também

Experiência de áudio/vídeo do Windows de qualidade (qWAVE)