Compartilhar via


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 membro InformationBuffer da estrutura NDIS_OID_REQUEST contém um ponteiro para uma estrutura de NDIS_QOS_CAPABILITIES .

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

A estrutura NDIS_QOS_CAPABILITIES contém informações sobre as funcionalidades de hardware de 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 Propriedades avançadas .

Nota Todos os recursos de hardware de 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 miniporte registram as funcionalidades de hardware do 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 NDIS_QOS_CAPABILITIES com os recursos de hardware do QoS do NDIS.

  2. O driver define o membro HardwareQosCapabilities da estrutura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES como um ponteiro para a estrutura 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 .

Nota O NDIS não relata os recursos de hardware de QoS do NDIS de um adaptador de rede para o excesso de drivers de protocolo e filtro 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.

Retornar códigos de status

O NDIS manipula a solicitação de consulta OID de OID_QOS_HARDWARE_CAPABILITIES solicitação de drivers de miniporte 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. 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.

Requisitos

Versão

Com suporte no NDIS 6.30 e posterior.

parâmetro

Ntddndis.h (inclua Ndis.h)

Confira também


MiniportInitializeEx

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES

NdisMSetMiniportAttributes

NDIS_OID_REQUEST

NDIS_QOS_CAPABILITIES