OID_QOS_REMOTE_PARAMETERS

Artigo
06/15/2023

Um driver sobreposto emite uma solicitação de consulta OID (identificador de objeto) de OID_QOS_REMOTE_PARAMETERS para obter os parâmetros de QoS (Qualidade de Serviço) do NDIS para um par remoto. O driver de miniporto usa esses parâmetros de QoS remotos para resolve seus parâmetros operacionais de QoS 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 membro InformationBuffer da estrutura NDIS_OID_REQUEST contém um ponteiro para uma estrutura de NDIS_QOS_PARAMETERS .

Nota Essa solicitação de consulta OID é válida apenas para drivers de miniporte que dão suporte à interface DCB (Ponte de Data Center) do IEEE 802.1.

Comentários

Quando o NDIS manipula a solicitação OID de OID_QOS_REMOTE_PARAMETERS com êxito, ele retorna os parâmetros remotos de QoS do NDIS armazenados em cache do NDIS_STATUS_QOS_REMOTE_PARAMETERS_CHANGE anterior status indicação que foi emitida pelo driver de miniporte. O driver emite essa status indicação para relatar o conjunto inicial de parâmetros de QoS do NDIS remoto. O driver também emite essa status indicação sempre que os parâmetros remotos de QoS do NDIS são alterados.

O NDIS retorna uma estrutura NDIS_QOS_PARAMETERS inicializada da seguinte maneira:

Se o driver de miniporte tiver emitido anteriormente uma indicação de NDIS_STATUS_QOS_REMOTE_PARAMETERS_CHANGE status, o NDIS armazenará em cache os dados NDIS_QOS_PARAMETERS e retornará esses dados para a solicitação de consulta OID de OID_QOS_REMOTE_PARAMETERS.
Se o driver de miniporto não tiver emitido um NDIS_STATUS_QOS_REMOTE_PARAMETERS_CHANGE status indicação, o NDIS retornará uma estrutura NDIS_QOS_PARAMETERS com todos os membros (com exceção do membro Header) definido como zero.

Para obter mais informações sobre parâmetros de QoS do NDIS remotos, consulte Visão geral dos parâmetros de QoS do NDIS.

Retornar códigos de status

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 miniporto não dá suporte à interface QoS do NDIS.
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.