Partilhar via


OID_NIC_SWITCH_ALLOCATE_VF

Um driver sobreposto emite uma solicitação de método OID (identificador de objeto) de OID_NIC_SWITCH_ALLOCATE_VF para alocar recursos para uma VF (Função Virtual) PCI Express (PCIe). O VF é exposto em um adaptador de rede que dá suporte à interface SR-IOV (virtualização de E/S de raiz única).

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

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

Comentários

O driver de miniporto PF aloca recursos de software para uma VF quando o driver manipula uma solicitação de método OID (identificador de objeto) de OID_NIC_SWITCH_ALLOCATE_VF. Embora os recursos de hardware tenham sido alocados para uma VF, ele é considerado não operacional até que o driver de miniporto PF conclua com êxito o OID_NIC_SWITCH_ALLOCATE_VF.

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

Nota Depois que um driver de sobreposição solicita a alocação de recursos para uma 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 de sobreposição possa ser interrompido, ele deve liberar os recursos para cada VF alocado pela solicitação de OID_NIC_SWITCH_ALLOCATE_VF do driver.

Códigos de status de retorno

O driver de miniporto 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 miniporto PF não dá suporte à interface SR-IOV (virtualização de E/S de raiz única) 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 miniporto PF deve definir o DATA. METHOD_INFORMATION. Membro BytesNeeded na estrutura NDIS_OID_REQUEST para o tamanho mínimo do buffer necessário.

NDIS_STATUS_FAILURE

A solicitação falhou por outros motivos.

Requisitos

Versão

Com suporte no NDIS 6.30 e posterior.

Cabeçalho

Ntddndis.h (inclua Ndis.h)

Confira também


NDIS_MAKE_RID

OID_NIC_SWITCH_CREATE_SWITCH

OID_NIC_SWITCH_CREATE_VPORT

NDIS_NIC_SWITCH_VF_PARAMETERS

OID_NIC_SWITCH_FREE_VF