OID_SRIOV_HARDWARE_CAPABILITIES

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

O InformationBuffer membro 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 os recursos de hardware do adaptador de rede, como se o adaptador suporta SR-IOV e se o driver de miniporta está gerenciando a função física (PF) ou a função virtual (VF) PCI Express (PCIe) ou a função virtual (VF) do adaptador. Esses recursos podem incluir os recursos de hardware que estão atualmente desativados pelas configurações do arquivo INF ou por meio da página de propriedades Avançado.

Observação Todos os recursos de 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 um recurso estar habilitado ou desabilitado.

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

Quando o NDIS lida com 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 suporta a interface de virtualização de E/S de raiz única (SR-IOV) ou não está habilitado para usar a interface.
NDIS_STATUS_INVALID_LENGTH	O buffer de informações era muito curto. O driver da miniporta deve definir a DATA. QUERY_INFORMATION. BytesNeeded membro na estrutura NDIS_OID_REQUEST para o tamanho mínimo de buffer necessário.
NDIS_STATUS_FAILURE	O pedido foi rejeitado por outros motivos.