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.
Um driver sobreposto emite uma solicitação de consulta de identificador de objeto (OID) de OID_QOS_REMOTE_PARAMETERS para obter os parâmetros de Qualidade de Serviço (QoS) NDIS para um par remoto. O driver de miniporta usa esses parâmetros de QoS remotos para resolver seus parâmetros operacionais de QoS do NDIS. O driver configura o adaptador de rede com os parâmetros operacionais para executar a transmissão de pacotes QoS.
Após um retorno bem-sucedido da solicitação de consulta OID, o InformationBuffer membro da estrutura NDIS_OID_REQUEST contém um ponteiro para uma estrutura NDIS_QOS_PARAMETERS.
Nota Esta solicitação de consulta OID é válida apenas para drivers de miniporta que suportam a interface IEEE 802.1 Data Center Bridging (DCB).
Comentários
Quando o NDIS lida com a solicitação OID de OID_QOS_REMOTE_PARAMETERS com êxito, ele retorna os parâmetros remotos de QoS do NDIS que havia armazenado em cache da indicação de status de NDIS_STATUS_QOS_REMOTE_PARAMETERS_CHANGE anterior emitida pelo driver de miniporta. O driver emite essa indicação de status para relatar o conjunto inicial de parâmetros remotos de QoS do NDIS. O driver também emite essa indicação de status sempre que os parâmetros remotos de QoS do NDIS mudam.
O NDIS retorna uma estrutura NDIS_QOS_PARAMETERS que é inicializada da seguinte maneira:
Se o driver de miniporta emitiu anteriormente uma indicação de status NDIS_STATUS_QOS_REMOTE_PARAMETERS_CHANGE, o NDIS armazena em cache os dados NDIS_QOS_PARAMETERS e retorna esses dados para a solicitação de consulta OID do OID_QOS_REMOTE_PARAMETERS.
Se o driver de miniporta não emitiu uma indicação de status NDIS_STATUS_QOS_REMOTE_PARAMETERS_CHANGE, o NDIS retornará uma estrutura NDIS_QOS_PARAMETERS com todos os membros (com exceção do membro Cabeçalho) definido como zero.
Para obter mais informações sobre parâmetros de QoS NDIS remotos, consulte Overview of NDIS QoS Parameters.
Códigos de status de retorno
O NDIS 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_NOT_SUPPORTED |
O driver de miniporta não suporta a interface NDIS QoS. |
NDIS_STATUS_INVALID_LENGTH |
O comprimento do buffer de informações é menor que sizeof(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) |
Ver também
NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE