OID_QOS_OPERATIONAL_PARAMETERS

Artigo
06/15/2023

Um driver sobreposto emite uma solicitação de consulta OID (identificador de objeto) de OID_QOS_OPERATIONAL_PARAMETERS para obter os parâmetros operacionais atuais de QoS (Qualidade de Serviço) do NDIS para um adaptador de rede. O driver de miniporto configura o adaptador de rede com os parâmetros operacionais de QoS do NDIS 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 é tratada pelo NDIS para drivers de miniport que dão suporte à interface DCB (Ponte de Data Center) do IEEE 802.1.

Comentários

Quando o NDIS manipula a solicitação de consulta OID de OID_QOS_OPERATIONAL_PARAMETERS com êxito, ele retorna os parâmetros operacionais de QoS do NDIS armazenados em cache do NDIS_STATUS_QOS_OPERATIONAL_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 operacionais de QoS do NDIS. O driver também emite essa status indicação sempre que os parâmetros operacionais 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 status NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE, o NDIS armazenará em cache os dados NDIS_QOS_PARAMETERS e retornará esses dados para a solicitação de consulta OID de OID_QOS_OPERATIONAL_PARAMETERS.
Se o driver de miniporto não tiver emitido um NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE indicação status, 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 operacionais de QoS do NDIS, 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.