OID_QOS_PARAMETERS

O componente DCB (Data Center Bridging) (Msdcb.sys) emite uma solicitação de método OID (identificador de objeto) de OID_QOS_PARAMETERS para configurar os parâmetros de QoS (Qualidade de Serviço) do NDIS local em um adaptador de rede.

O membro InformationBuffer da estrutura NDIS_OID_REQUEST contém um ponteiro para uma estrutura NDIS_QOS_PARAMETERS.

Observação essa solicitação de método OID é obrigatória para drivers de miniporto que dão suporte ao NDIS QoS para a interface DCB (Ponte de Data Center) do IEEE 802.1.

Observações

Os drivers de miniporto obtêm os parâmetros de QoS do NDIS local por meio de uma solicitação de método OID de OID_QOS_PARAMETERS. Esses parâmetros definem como o adaptador de rede prioriza transmitir ou saída, pacotes. Para obter mais informações sobre esses parâmetros, consulte Visão geral dos parâmetros de QoS do NDIS.

Observação somente o componente DCB pode emitir uma solicitação de método OID de OID_QOS_PARAMETERS. Um driver de filtro ou protocolo sobreposto não deve emitir essa OID. Para obter mais informações sobre o componente DCB, consulte arquitetura de QoS do NDIS parade ponte do Data Center.

O componente DCB emite uma solicitação OID_QOS_PARAMETERS nas seguintes condições:

  • O administrador do sistema instala ou desinstala o recurso de servidor microsoft DCB.

    Para obter mais informações sobre o recurso de servidor DCB, consulte System-Provided componentes do DCB.

  • O administrador do sistema habilita ou desabilita o recurso do servidor DCB enquanto o recurso ainda está instalado.

  • O administrador do sistema altera qualquer um dos parâmetros de recurso do servidor DCB.

  • O sistema operacional inicia ou reinicia enquanto o recurso de servidor DCB está instalado.

Quando o driver de miniporto manipula a solicitação de método OID de OID_QOS_PARAMETERS, ele deve seguir estas diretrizes:

  • O driver de miniporto copia os dados dentro da estrutura NDIS_QOS_PARAMETERS para seu cache de parâmetros locais de QoS do NDIS. Em seguida, o driver resolve seus parâmetros operacionais de QoS do NDIS com base em seu cache de parâmetros locais de QoS do NDIS e seu cache de parâmetros de QoS NDIS que recebeu de um par remoto.

    Para obter mais informações sobre como o driver de miniporto resolve seus parâmetros operacionais, consulte Resolvendo parâmetros operacionais de QoS do NDIS.

  • O driver de miniporto não deve modificar nenhum dado contido na estrutura de NDIS_QOS_PARAMETERS. O driver deve concluir a solicitação do método OID e retornar os dados originais dentro da estrutura de NDIS_QOS_PARAMETERS.

  • O sinalizador NDIS_QOS_PARAMETERS_WILLING especifica se o driver de miniporto habilita ou desabilita o estado disposto do DCBX (Data Center Bridging Exchange). O driver manipula esse sinalizador da seguinte maneira:

    • Se esse sinalizador estiver definido, o driver de miniporto deverá habilitar o estado local do DCBX Willing. Isso permite que o driver seja configurado remotamente com configurações de QoS. Nesse caso, o driver resolve seus parâmetros de QoS operacionais com base nos parâmetros de QoS remotos. O driver de miniporto também pode resolver seus parâmetros de QoS operacionais com base em quaisquer configurações de QoS proprietárias definidas pelo fornecedor de hardware independente (IHV).

    • Se esse sinalizador não estiver definido, o driver de miniporto deverá desabilitar o estado local do DCBX Willing. Isso permite que o driver resolva seus parâmetros de QoS operacionais de seus parâmetros de QoS locais em vez de parâmetros de QoS remotos. O driver de miniporto também deve desabilitar ou substituir qualquer parâmetro QoS local para o qual o sinalizador de NDIS_QOS_PARAMETERS_Xxx_CONFIGURED relacionado não está definido.

      Por exemplo, o driver de miniporto pode substituir um parâmetro QoS local não configurado com suas configurações proprietárias para o parâmetro QoS definido pelo IHV. Se não houver configurações proprietárias para parâmetros de QoS locais que não sejam especificados com um sinalizador NDIS_QOS_PARAMETERS_Xxx_CONFIGURED, o driver deverá desabilitar o uso desses parâmetros de QoS no adaptador de rede.

      Observação O driver também poderá substituir os parâmetros de QoS locais configurados se eles comprometerem os parâmetros de QoS usados por protocolos ou tecnologias habilitadas no adaptador de rede. Por exemplo, o driver poderá substituir os parâmetros locais do QoS se o adaptador de rede estiver habilitado para inicialização remota por meio do protocolo Fibre Channel via Ethernet (FCoE).

    Para obter mais informações sobre o estado local do DCBX Willing, consulte Gerenciando ode Estado Disposto do DCBX local.

Para obter mais informações sobre como o driver de miniporto substitui os parâmetros locais de QoS, consulte Gerenciamento de parâmetros QoS do NDIS.

Observação Substituir os parâmetros de QoS locais não deve fazer com que o driver de miniporte falhe na solicitação de método OID de OID_QOS_PARAMETERS.

Para obter mais informações sobre como o driver de miniporto gerencia os parâmetros locais do QoS, consulte Definindo parâmetros de QoS do NDIS local.

Códigos de status de retorno

O driver de miniporto retorna um dos seguintes códigos de status.

Código de status Descrição

NDIS_STATUS_SUCCESS

A solicitação OID foi concluída com êxito.

NDIS_STATUS_PENDING

A solicitação OID está pendente de conclusão. Quando o driver de miniporto chama NdisMOidRequestComplete, o NDIS passará o código de status final e os resultados para o manipulador de conclusão da solicitação OID do chamador após a conclusão da solicitação.

NDIS_STATUS_NOT_SUPPORTED

O driver de miniporto não dá suporte à interface QoS do NDIS.

NDIS_STATUS_INVALID_PARAMETER

Um ou mais membros da estrutura NDIS_QOS_PARAMETERS contêm valores incorretos.

NDIS_STATUS_INVALID_LENGTH

O comprimento do buffer de informações é menor que tamanho de(NDIS_QOS_PARAMETERS). O NDIS define os dados de . QUERY_INFORMATION. BytesNeededed membro na estrutura NDIS_OID_REQUEST para o tamanho mínimo do buffer necessário.

NDIS_STATUS_FAILURE

A solicitação falhou por outros motivos.

Requisitos

Versão

Com suporte no NDIS 6.30 e posterior.

Cabeçalho

Ntddndis.h (inclua Ndis.h)

Consulte também


NdisMOidRequestComplete

NDIS_OID_REQUEST

NDIS_QOS_CAPABILITIES

NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE

NDIS_STATUS_QOS_REMOTE_PARAMETERS_CHANGE