OID_NIC_SWITCH_FREE_VF
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 sobrepostos emitem essa solicitação de conjunto de OID para o driver de miniporto para a PF (Função Física PCIe) do adaptador de rede. Essa solicitação de conjunto de OID é necessária para drivers de miniporte PF que dão suporte à interface sr-IOV (virtualização de E/S) raiz única.
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 membro VFId 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 de OID de OID_NIC_SWITCH_FREE_VF para liberar os recursos de um 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.
Nota Depois que um driver de sobreposição 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 sobressoido possa ser interrompido, ele deve liberar os recursos para cada VF alocado pela solicitação de OID_NIC_SWITCH_ALLOCATE_VF do driver.
Retornar códigos de status
A função MiniportOidRequest do driver de miniport retorna um dos seguintes valores para esta solicitação:
| Termo | Descrição |
|---|---|
NDIS_STATUS_SUCCESS |
O driver de miniporte concluiu a solicitação com êxito. |
NDIS_STATUS_PENDING |
O driver de miniporte 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ção NdisMOidRequestComplete , passando NDIS_STATUS_SUCCESS para o parâmetro Status . |
NDIS_STATUS_NOT_ACCEPTED |
O driver de miniporte 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:
| Termo | 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 um VF que não foi alocado 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. SET_INFORMATION. Membro BytesNeeded na estrutura NDIS_OID_REQUEST para o tamanho mínimo do buffer necessário. |
Requisitos
Versão |
Com suporte no NDIS 6.30 e posterior. |
Cabeçalho |
Ntddndis.h (inclua Ndis.h) |