OID_SRIOV_CURRENT_CAPABILITIES

2025-03-13

Um driver em excesso emite uma solicitação de consulta OID (identificador de objeto) de OID_SRIOV_CURRENT_CAPABILITIES para obter os recursos atuais de virtualização de E/S de raiz única (SR-IOV) de um adaptador de rede.

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

Observações

A partir do NDIS 6.30, os drivers de miniporto fornecem os recursos de hardware SR-IOV habilitados no adaptador de rede quando sua função MiniportInitializeEx é chamada. O driver inicializa uma estrutura NDIS_SRIOV_CAPABILITIES com os recursos de hardware SR-IOV atualmente habilitados e define o CurrentSriovCapabilities membro 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.

Drivers de filtro e protocolos sobrepostos não precisam emitir solicitações de consulta OID de OID_SRIOV_CURRENT_CAPABILITIES. O NDIS fornece os recursos de SR-IOV atualmente habilitados de um adaptador de rede para esses drivers da seguinte maneira:

O NDIS relata os recursos de SR-IOV atualmente habilitados de um adaptador de rede subjacente a drivers de protocolo sobressociáveis no SriovCapabilities membro da estrutura NDIS_BIND_PARAMETERS durante a operação de associação.
O NDIS relata as funcionalidades de SR-IOV atualmente habilitadas de um adaptador de rede subjacente a drivers de filtro sobressociáveis no SriovCapabilities membro da estrutura NDIS_FILTER_ATTACH_PARAMETERS durante a operação de anexação.

Códigos de status de retorno

O NDIS manipula a solicitação de consulta OID da solicitação OID_SRIOV_CURRENT_CAPABILITIES para drivers de miniporto. Os drivers não serão emitidos nesta solicitação OID.

Quando o NDIS manipula a solicitação OID_SRIOV_CURRENT_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 miniporto não dá suporte à interface de virtualização de E/S 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 de miniporto deve definir a DATA. 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.