Partilhar via


OID_SRIOV_RESET_VF

Os drivers em excesso emitem uma solicitação de conjunto de 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 de raiz única. Os 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 membro VFId dessa estrutura.

Comentários

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 do Hyper-V. Drivers sobrepostos 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.

Quando ele lida com essa solicitação de OID, o driver de miniporto PF deve seguir estas diretrizes:

  • O driver de miniporto PF deve verificar se o VF, especificado pelo membro VFId da estrutura NDIS_SRIOV_RESET_VF_PARAMETERS , tem recursos que foram alocados anteriormente. O driver de miniporto PF aloca recursos para uma 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 OID.

  • A operação de redefinição só deve afetar o VF especificado. A operação não deve afetar outras 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 SR-IOV (virtualização de E/S de raiz única) ou não está habilitado para usar a interface .

NDIS_STATUS_INVALID_PARAMETER

Um ou mais dos 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. 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)

Confira também


NDIS_OID_REQUEST

NDIS_SRIOV_RESET_VF_PARAMETERS

OID_NIC_SWITCH_ALLOCATE_VF