OID_SRIOV_CURRENT_CAPABILITIES
Um driver sobreposto emite uma solicitação de consulta OID (identificador de objeto) de OID_SRIOV_CURRENT_CAPABILITIES para obter os recursos atuais de SR-IOV (virtualização de E/S raiz única) de um adaptador de rede.
O membro InformationBuffer da estrutura NDIS_OID_REQUEST contém um ponteiro para a estrutura NDIS_SRIOV_CAPABILITIES .
Comentários
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 membro CurrentSriovCapabilities 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 protocolo e filtro sobrepostos não precisam emitir solicitações de consulta OID de OID_SRIOV_CURRENT_CAPABILITIES. O NDIS fornece os recursos SR-IOV atualmente habilitados de um adaptador de rede para esses drivers da seguinte maneira:
O NDIS relata as funcionalidades sr-IOV atualmente habilitadas de um adaptador de rede subjacente para drivers de protocolo sobressociáveis no membro SriovCapabilities da estrutura NDIS_BIND_PARAMETERS durante a operação de associação.
O NDIS relata os recursos sr-IOV atualmente habilitados de um adaptador de rede subjacente para drivers de filtro sobressociados no membro SriovCapabilities da estrutura NDIS_FILTER_ATTACH_PARAMETERS durante a operação de anexação.
Retornar códigos de status
O NDIS manipula a solicitação de consulta OID da solicitação de OID_SRIOV_CURRENT_CAPABILITIES para drivers de miniporte. Os drivers não serão emitidos nesta solicitação de OID.
Quando o NDIS manipula a solicitação de 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 miniporte não dá suporte à interface sr-IOV (virtualização de E/S raiz) ou não está habilitado para usar a interface. |
NDIS_STATUS_INVALID_LENGTH |
O buffer de informações era muito curto. O driver de miniporte 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. |
parâmetro |
Ntddndis.h (inclua Ndis.h) |