OID_SRIOV_RESET_VF
Drivers em excesso emitem uma solicitação de conjunto OID (identificador de objeto) de OID_SRIOV_RESET_VF para redefinir uma VF (função virtual) PCI Express (PCIe) especificada em um adaptador de rede que dá suporte à virtualização de E/S raiz única. Drivers em excesso emitem essa solicitação de conjunto de OID para o driver de miniporto da PF (Função Física) PCI Express (PCIe) do adaptador de rede.
O membro InformationBuffer da estrutura NDIS_OID_REQUEST contém um ponteiro para uma estrutura NDIS_SRIOV_RESET_VF_PARAMETERS. O driver sobreposto especifica o identificador do VF a ser redefinido por meio do VFId membro dessa estrutura.
Observações
Uma VF pode ser redefinida por meio de uma FLR (Redefinição de Nível de Função) PCI Express (PCIe). Como a solicitação FLR é uma operação privilegiada, ela só pode ser executada pelo driver de miniporto PF executado no sistema operacional de gerenciamento de uma partição pai Hyper-V. Drivers sobrepostos que são executados no sistema operacional de gerenciamento são notificados da solicitação FLR e emitem a solicitação de conjunto de OID de OID_SRIOV_RESET_VF para o driver de miniporto PF.
Ao lidar com essa solicitação OID, o driver de miniporto PF deve seguir estas diretrizes:
O driver de miniporto PF deve verificar se o VF, especificado pelo VFId membro da estrutura NDIS_SRIOV_RESET_VF_PARAMETERS, tem recursos que foram alocados anteriormente. O driver de miniporto PF aloca recursos para um VF durante uma solicitação de método OID de OID_NIC_SWITCH_ALLOCATE_VF. Se os recursos para o VF especificado não tiverem sido alocados, o driver deverá falhar na solicitação de OID.
A operação de redefinição deve afetar apenas o VF especificado. A operação não deve afetar outros VFs ou o PF no mesmo adaptador de rede.
Para obter mais informações, consulte Redefinindo uma função virtual.
Códigos de status de retorno
O driver de miniporto PF retorna um dos seguintes códigos de status para a solicitação definida de OID_SRIOV_RESET_VF.
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 PF 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_PARAMETER |
Um ou mais membros da estrutura NDIS_SRIOV_RESET_VF_PARAMETERS têm valores inválidos. |
NDIS_STATUS_INVALID_LENGTH |
O buffer de informações era muito curto. O driver de miniporto PF deve definir o data . SET_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. |
Requisitos
Versão |
Com suporte no NDIS 6.30 e posterior. |
Cabeçalho |
Ntddndis.h (inclua Ndis.h) |