OID_SRIOV_HARDWARE_CAPABILITIES
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. |
Requisitos
Versão |
Com suporte no NDIS 6.30 e posterior. |
Cabeçalho |
Ntddndis.h (inclua Ndis.h) |