OID_NIC_SWITCH_FREE_VF

2025-03-13

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

Drivers em excesso emitem essa solicitação de conjunto de OID para o driver de miniporto para o PF (Função Física PCIe) do adaptador de rede. Essa solicitação de conjunto de OID é necessária para drivers de miniporto PF que dão suporte à interface de virtualização de E/S raiz única (SR-IOV).

O membro InformationBuffer 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 por meio 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.

Observações

Um driver sobreposto emite uma solicitação de conjunto de OID de OID_NIC_SWITCH_FREE_VF para liberar os recursos de uma VF. Esses recursos foram alocados anteriormente 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 de VF, consulte Liberando recursos para uma função virtual.

Observação Uma vez que um driver em excesso solicita a 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 de OID de OID_NIC_SWITCH_FREE_VF para liberar os recursos do VF. Antes que o driver em excesso possa ser interrompido, ele deve liberar os recursos para cada VF que foi alocado pela solicitação de OID_NIC_SWITCH_ALLOCATE_VF do driver.

Retornar códigos de status

A funçãoMiniportOidRequestdo driver de miniporto retorna um dos seguintes valores para esta solicitação:

Prazo	Descrição
NDIS_STATUS_SUCCESS	O driver de miniporto concluiu a solicitação com êxito.
NDIS_STATUS_PENDING	O driver de miniporto concluirá a solicitação de forma assíncrona. Depois que o driver de miniporto tiver concluído todo o processamento, ele deverá ter êxito na solicitação chamando a funçãoNdisMOidRequestComplete, passando NDIS_STATUS_SUCCESS para o parâmetro status do.
NDIS_STATUS_NOT_ACCEPTED	O driver de miniporto está sendo redefinido.
NDIS_STATUS_REQUEST_ABORTED	O driver de miniporto parou de processar a solicitação. Por exemplo, o NDIS chamou a função MiniportResetEx.

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

Prazo	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 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 uma VF que não foi alocada ou que tenha VPorts que não foram excluídos.
NDIS_STATUS_INVALID_LENGTH	O buffer de informações é muito pequeno. O NDIS define os dados de . SET_INFORMATION. BytesNeededed membro na estrutura NDIS_OID_REQUEST para o tamanho mínimo do buffer necessário.