OID_QOS_HARDWARE_CAPABILITIES

Um driver sobreposto emite uma solicitação de consulta OID (identificador de objeto) de OID_QOS_HARDWARE_CAPABILITIES para obter os recursos de hardware de QoS (Qualidade de Serviço) do NDIS de um adaptador de rede.

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 de NDIS_QOS_CAPABILITIES.

Observação essa solicitação de consulta OID é tratada pelo NDIS para drivers de miniporto que dão suporte à interface DCB (Ponte de Data Center) do IEEE 802.1.

Observações

A estrutura de NDIS_QOS_CAPABILITIES contém informações sobre as funcionalidades de hardware do QoS do NDIS de um adaptador de rede. Esses recursos podem incluir recursos de hardware que estão atualmente desabilitados pelas configurações de arquivo INF ou por meio da página de propriedades avançados do.

Observação todos os recursos de hardware do QoS do NDIS de um adaptador de rede são retornados por meio de uma solicitação de consulta OID de OID_QOS_HARDWARE_CAPABILITIES, independentemente de uma funcionalidade estar habilitada ou desabilitada.

Os drivers de miniporto registram as funcionalidades de hardware de QoS do NDIS de um adaptador de rede quando sua função MiniportInitializeEx é chamada. O driver registra esses recursos seguindo estas etapas:

  1. O driver inicializa uma estrutura de NDIS_QOS_CAPABILITIES com os recursos de hardware do QoS do NDIS.

  2. O driver define o HardwareQosCapabilities membro da estrutura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES como um ponteiro para a estrutura de NDIS_QOS_CAPABILITIES.

  3. Em seguida, o driver de miniporto chama a função NdisMSetMiniportAttributes e define o parâmetro MiniportAttributes como um ponteiro para uma estrutura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES.

Observação NDIS não relata os recursos de hardware QoS do NDIS de um adaptador de rede para drivers de filtro e protocolos sobressociáveis durante as operações de associação ou anexação.

Para obter mais informações sobre como registrar recursos de QoS do NDIS, consulte Registrando recursos de QoS do NDIS.

Códigos de status de retorno

O NDIS manipula a solicitação de consulta OID de OID_QOS_HARDWARE_CAPABILITIES solicitação de drivers de miniporto e 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_CAPABILITIES). O NDIS define os dados de . QUERY_INFORMATION. BytesNeededed membro na estrutura NDIS_OID_REQUEST para o tamanho mínimo do buffer necessário.

NDIS_STATUS_FAILURE

A solicitação falhou por outros motivos.

Requisitos

Versão

Com suporte no NDIS 6.30 e posterior.

Cabeçalho

Ntddndis.h (inclua Ndis.h)

Consulte também


MiniportInitializeEx

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES

NdisMSetMiniportAttributes

NDIS_OID_REQUEST

NDIS_QOS_CAPABILITIES