Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
O componente DCB (Data Center Bridging) (Msdcb.sys) emite uma solicitação de método de identificador de objeto (OID) de OID_QOS_PARAMETERS para configurar os parâmetros locais de Qualidade de Serviço (QoS) NDIS em um adaptador de rede.
O InformationBuffer membro da estrutura NDIS_OID_REQUEST contém um ponteiro para uma estrutura NDIS_QOS_PARAMETERS.
Nota Esta solicitação de método OID é obrigatória para drivers de miniporta que suportam NDIS QoS para a interface IEEE 802.1 Data Center Bridging (DCB).
Comentários
Os drivers de miniporta obtêm os parâmetros de QoS NDIS locais 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 Overview of NDIS QoS Parameters.
Observação Somente o componente DCB pode emitir uma solicitação de método OID de OID_QOS_PARAMETERS. Um protocolo sobreposto ou driver de filtro não deve emitir esse OID. Para obter mais informações sobre o componente DCB, consulte NDIS QoS Architecture for Data Center Bridging.
O componente DCB emite uma solicitação de 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 DCB Components.
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 de QoS do NDIS locais e seu cache de parâmetros de QoS do NDIS que recebeu de um par remoto.
Para obter mais informações sobre como o driver de miniporta resolve seus parâmetros operacionais, consulte Resolvendo parâmetros operacionais NDIS QoS.
O driver da miniporta não deve modificar nenhum dado contido 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 (Data Center Bridging Exchange) Willing . O driver lida com esse sinalizador da seguinte maneira:
Se esse sinalizador estiver definido, o driver de miniporta deverá habilitar o estado DCBX Willing local. Isso permite que o driver seja configurado remotamente com as 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 miniporta também pode resolver seus parâmetros operacionais de QoS com base em quaisquer configurações proprietárias de QoS definidas pelo fornecedor independente de hardware (IHV).
Se esse sinalizador não estiver definido, o driver de miniporta deverá desabilitar o estado DCBX Willing local. Isso permite que o driver resolva seus parâmetros de QoS operacionais a partir 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 de QoS local para o qual o sinalizador de_CONFIGURED NDIS_QOS_PARAMETERS_Xxx relacionado não esteja definido.
Por exemplo, o driver de miniporta 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 são especificados com um sinalizador de_CONFIGURED NDIS_QOS_PARAMETERS_Xxx, o driver deve desabilitar o uso desses parâmetros de QoS no adaptador de rede.
Observação O driver também pode substituir parâmetros de QoS locais configurados se eles comprometerem os parâmetros de QoS usados por protocolos ou tecnologias habilitados no adaptador de rede. Por exemplo, o driver pode substituir os parâmetros de QoS locais se o adaptador de rede estiver habilitado para inicialização remota por meio do protocolo Fibre Channel over Ethernet (FCoE).
Para obter mais informações sobre o estado DCBX Willing local, consulte Managing the Local DCBX Willing State.
Para obter mais informações sobre como o driver de miniporta substitui os parâmetros de QoS locais, consulte Managing NDIS QoS Parameters.
Observação Substituir os parâmetros de QoS locais não deve fazer com que o driver de miniporta falhe na solicitação de método OID de OID_QOS_PARAMETERS.
Para obter mais informações sobre como o driver de miniporta gerencia os parâmetros de QoS locais, consulte Setting Local NDIS QoS Parameters.
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 miniporta chama 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 suporta a interface NDIS QoS. |
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. QUERY_INFORMATION. BytesNeeded membro na estrutura NDIS_OID_REQUEST para o tamanho mínimo de buffer necessário. |
NDIS_STATUS_FAILURE |
O pedido foi rejeitado por outros motivos. |
Requerimentos
Versão |
Suportado no NDIS 6.30 e posterior. |
Cabeçalho |
Ntddndis.h (inclui Ndis.h) |