OID_QOS_PARAMETERS

Artigo
06/15/2023

O componente dcb (ponte do data center) (Msdcb.sys) emite uma solicitação de método OID (identificador de objeto) de OID_QOS_PARAMETERS para configurar os parâmetros locais de QoS (Qualidade de Serviço) do NDIS em um adaptador de rede.

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

Nota Essa solicitação de método OID é obrigatória para drivers de miniporta que dão suporte a QoS NDIS para a interface DCB (ponte de data center) do IEEE 802.1.

Comentários

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

Nota 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 esse OID. Para obter mais informações sobre o componente DCB, consulte Arquitetura de QoS do NDIS para ponte do Data Center.

O componente DCB emite uma solicitação de OID_QOS_PARAMETERS sob as 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 Componentes dcb fornecidos pelo sistema.
O administrador do sistema habilita ou desabilita o recurso de 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 é iniciado ou reiniciado enquanto o recurso de servidor DCB está instalado.

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

O driver de miniporta 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 miniporta não deve modificar os dados contidos na estrutura NDIS_QOS_PARAMETERS . O driver deve concluir a solicitação do método OID e retornar os dados originais dentro da estrutura NDIS_QOS_PARAMETERS .
O sinalizador NDIS_QOS_PARAMETERS_WILLING especifica se o driver de miniporta habilita ou desabilita o estado local dcbx (Troca de Pontes do Data Center). 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 operacionais de QoS com base nos parâmetros de QoS remotos. O driver de miniporto também pode resolve seus parâmetros operacionais de QoS com base em quaisquer configurações de QoS proprietárias definidas pelo IHV (fornecedor independente de hardware).
- Se esse sinalizador não estiver definido, o driver de miniporto deverá desabilitar o estado local do DCBX Willing. Isso permite que o driver resolve seus parâmetros de QoS operacionais de seus parâmetros de QoS locais em vez de parâmetros de QoS remotos. O driver de miniporta também deve desabilitar ou substituir qualquer parâmetro QoS local para o qual o sinalizador NDIS_QOS_PARAMETERS_Xxx_CONFIGURED relacionado não esteja definido.
  
  Por exemplo, o driver de miniporto pode substituir um parâmetro QoS local não configurado por 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.
  
  Nota 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 de QoS locais se o adaptador de rede estiver habilitado para inicialização remota por meio do protocolo Fibre Channel por Ethernet (FCoE).
Para obter mais informações sobre o estado local do DCBX Willing, consulte Managing the Local DCBX Willing State.

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

Nota 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 de QoS locais, consulte Definindo parâmetros de QoS do NDIS local.

Códigos de status de retorno

O driver de miniporta 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 chamar NdisMOidRequestComplete, o NDIS passará o código de status final e os resultados para o manipulador de conclusão de solicitação OID do chamador após a conclusão da solicitação.
NDIS_STATUS_NOT_SUPPORTED	O driver de miniporta 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 sizeof(NDIS_QOS_PARAMETERS). O NDIS define os DADOS. QUERY_INFORMATION. Membro BytesNeeded na estrutura NDIS_OID_REQUEST para o tamanho mínimo do buffer necessário.
NDIS_STATUS_FAILURE	A solicitação falhou por outros motivos.