OID_SRIOV_RESET_VF

Os drivers sobrepostos emitem uma solicitação de conjunto de identificador de objeto (OID) de OID_SRIOV_RESET_VF para redefinir uma função virtual (VF) PCI Express (PCIe) especificada em um adaptador de rede que suporta virtualização de E/S de raiz única. Drivers sobrepostos emitem essa solicitação de conjunto OID para o driver de miniporta da função física (PF) PCI Express (PCIe) do adaptador de rede.

O InformationBuffer membro 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 através do VFId membro dessa estrutura.

Comentários

Um VF pode ser redefinido através de um PCI Express (PCIe) Function Level Reset (FLR). Como a solicitação FLR é uma operação privilegiada, ela só pode ser executada pelo driver de miniporta PF executado no sistema operacional de gerenciamento de uma partição pai Hyper-V. Os 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 OID de OID_SRIOV_RESET_VF para o driver de miniporta PF.

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

• O driver de miniporta 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 miniporta 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 foram alocados, o driver deve falhar a solicitação 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 Redefinir uma função virtual.

Códigos de status de retorno

O driver de miniporta 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 miniporta PF 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_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 miniporta PF deve definir o DATA. SET_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.

Requerimentos

Versão	Suportado no NDIS 6.30 e posterior.
Cabeçalho	Ntddndis.h (inclui Ndis.h)

Ver também

---

NDIS_OID_REQUEST

NDIS_SRIOV_RESET_VF_PARAMETERS

OID_NIC_SWITCH_ALLOCATE_VF