OID_SRIOV_HARDWARE_CAPABILITIES

Artigo
06/15/2023

Um driver sobreposto emite uma solicitação de consulta OID (identificador de objeto) de OID_SRIOV_HARDWARE_CAPABILITIES para obter as funcionalidades de hardware sr-IOV (virtualização de E/S de raiz única) do adaptador de rede.

O membro InformationBuffer da estrutura NDIS_OID_REQUEST contém um ponteiro para a estrutura NDIS_SRIOV_CAPABILITIES .

Comentários

A estrutura NDIS_SRIOV_CAPABILITIES contém informações sobre as funcionalidades de hardware do adaptador de rede, como se o adaptador dá suporte a SR-IOV e se o driver de miniporto está gerenciando a PF (Função Física) PCI Express (PCIe) do adaptador ou a VF (Função Virtual). Esses recursos podem incluir os recursos de hardware que estão desabilitados atualmente pelas configurações de arquivo INF ou por meio da página Propriedades avançadas .

Nota Todos os recursos SR-IOV do adaptador de rede são retornados por meio de uma solicitação de consulta OID de OID_SRIOV_HARDWARE_CAPABILITIES, independentemente de uma funcionalidade estar habilitada ou desabilitada.

A partir do NDIS 6.30, os drivers de miniporto fornecem as funcionalidades de hardware SR-IOV quando sua função MiniportInitializeEx é chamada. O driver inicializa uma estrutura NDIS_SRIOV_CAPABILITIES com os recursos de hardware SR-IOV e define o membro HardwareSriovCapabilities da estrutura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES como um ponteiro para a estrutura NDIS_SRIOV_CAPABILITIES . 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 .

Códigos de status de retorno

O NDIS lida com a solicitação de consulta OID da solicitação de OID_SRIOV_HARDWARE_CAPABILITIES para drivers de miniporta. Os drivers não serão emitidos nesta solicitação de OID.

Quando o NDIS manipula a solicitação de OID_SRIOV_HARDWARE_CAPABILITIES, ele 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 dá suporte à interface SR-IOV (virtualização de E/S de raiz única) ou não está habilitado para usar a interface .
NDIS_STATUS_INVALID_LENGTH	O buffer de informações era muito curto. O driver de miniporta deve definir 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.