Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Um driver sobreposto emite uma solicitação de método de identificador de objeto (OID) de OID_NIC_SWITCH_ALLOCATE_VF para alocar recursos para uma função virtual (VF) PCI Express (PCIe). O VF é exposto em um adaptador de rede que suporta a interface de virtualização de E/S de raiz única (SR-IOV).
Drivers sobrepostos emitem essa solicitação de método OID para o driver de miniporta para a função física PCIe (PF) do adaptador de rede. Essa solicitação de método 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_VF_PARAMETERS.
Comentários
O driver de miniporta PF aloca recursos de software para um VF quando o driver lida com uma solicitação de método de identificador de objeto (OID) de OID_NIC_SWITCH_ALLOCATE_VF. Mesmo que os recursos de hardware tenham sido alocados para um VF, ele é considerado não operacional até que o driver de miniporta PF conclua com êxito o OID_NIC_SWITCH_ALLOCATE_VF.
Para obter mais informações sobre como alocar recursos VF, consulte Allocating Resources for a Virtual Function.
Observação Depois que 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 sobrejacente 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
O driver de miniporta PF retorna um dos seguintes códigos de status para a solicitação de método OID de OID_NIC_SWITCH_ALLOCATE_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_NIC_SWITCH_VF_PARAMETERS têm valores inválidos. |
NDIS_STATUS_INVALID_LENGTH |
O comprimento do buffer de informações é menor que sizeof(NDIS_NIC_SWITCH_VF_PARAMETERS). O driver de miniporta PF deve definir o DATA. METHOD_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) |