OID_NIC_SWITCH_FREE_VF

Um driver sobreposto emite uma solicitação de conjunto de identificador de objeto (OID) de OID_NIC_SWITCH_FREE_VF para liberar os recursos para a função virtual (VF) PCI Express (PCIe) de um adaptador de rede.

Drivers sobrepostos emitem essa solicitação de conjunto OID para o driver de miniporta para a função física PCIe (PF) do adaptador de rede. Essa solicitação de conjunto OID é necessária para drivers de miniporta PF que suportam a interface de virtualização de E/S de raiz única (SR-IOV).

O InformationBuffer membro da estrutura NDIS_OID_REQUEST contém um ponteiro para uma estrutura NDIS_NIC_SWITCH_FREE_VF_PARAMETERS.

O driver sobreposto especifica o identificador do VF a ser liberado através do VFId membro dessa estrutura. O driver obteve esse identificador de uma solicitação de método OID anterior de OID_NIC_SWITCH_ALLOCATE_VF.

Comentários

Um driver sobreposto emite uma solicitação de conjunto OID de OID_NIC_SWITCH_FREE_VF para liberar os recursos para um VF. Esses recursos foram previamente alocados por meio de uma solicitação de método OID de OID_NIC_SWITCH_ALLOCATE_VF.

Para obter mais informações sobre como liberar recursos VF, consulte Liberando recursos para uma função virtual.

Nota Quando um driver sobreposto solicita alocação de recursos para um VF, esse driver é o único componente que pode solicitar a liberação dos recursos para o mesmo VF. O driver sobreposto deve emitir uma solicitação de conjunto OID de OID_NIC_SWITCH_FREE_VF para liberar os recursos VF. Antes que o motorista sobrejacente possa ser parado, ele deve liberar os recursos para cada VF que foi alocado pela solicitação de OID_NIC_SWITCH_ALLOCATE_VF do motorista.

Códigos de status de retorno

A funçãoMiniportOidRequest do driver de miniportaretorna um dos seguintes valores para essa solicitação:

Vigência	Descrição
NDIS_STATUS_SUCCESS	O driver da miniporta concluiu a solicitação com êxito.
NDIS_STATUS_PENDING	O driver de miniporta concluirá a solicitação de forma assíncrona. Depois que o driver de miniporta tiver concluído todo o processamento, ele deverá executar a solicitação chamando a função NdisMOidRequestComplete e passando NDIS_STATUS_SUCCESS para o parâmetro Status .
NDIS_STATUS_NOT_ACCEPTED	O driver da miniporta está sendo redefinido.
NDIS_STATUS_REQUEST_ABORTED	O driver da miniporta parou de processar a solicitação. Por exemplo, o NDIS chamou a funçãoMiniportResetEx.

O NDIS retorna um dos seguintes códigos de status para essa solicitação:

Vigência	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 SR-IOV ou não está habilitado para usar a interface.
NDIS_STATUS_FILE_NOT_FOUND	Um ou mais dos membros da estrutura NDIS_NIC_SWITCH_FREE_VF_PARAMETERS têm valores inválidos. Por exemplo, o membro VFId pode especificar um VF que não foi alocado ou que tem VPorts que não foram excluídos.
NDIS_STATUS_INVALID_LENGTH	O buffer de informações é muito pequeno. O NDIS define os DADOS. SET_INFORMATION. BytesNeeded membro na estrutura NDIS_OID_REQUEST para o tamanho mínimo de buffer necessário.