Compartilhar via


OID_NIC_SWITCH_DELETE_VPORT

Um driver em excesso emite uma solicitação de conjunto OID (identificador de objeto) de OID_NIC_SWITCH_DELETE_VPORT para excluir uma VPort (porta virtual não padrão) que foi criada anteriormente no comutador NIC de um adaptador de rede. O driver sobreposto pode excluir um VPort que ele criou anteriormente apenas emitindo uma solicitação de método OID de OID_NIC_SWITCH_CREATE_VPORT.

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 a estrutura NDIS_NIC_SWITCH_DELETE_VPORT_PARAMETERS.

Observações

Um driver em excesso, como um driver de protocolo ou filtro, só pode excluir um VPort não padrão criado anteriormente. O driver sobreposto cria um VPort emitindo uma solicitação de método OID de OID_NIC_SWITCH_CREATE_VPORT.

Quando o driver de miniporto PF recebe a solicitação OID de OID_NIC_SWITCH_DELETE_VPORT, o driver deve liberar os recursos de hardware e software que foram alocados para o VPort especificado.

Para obter mais informações, consulte Excluindo uma porta virtual.

Observação Somente VPorts não padrão podem ser excluídos explicitamente por meio de solicitações OID de OID_NIC_SWITCH_DELETE_VPORT. O VPort padrão é excluído implicitamente quando o driver de miniporto PF exclui o comutador NIC padrão. Para obter mais informações, consulte Excluindo umde comutador NIC.

Códigos de status de retorno

O driver de miniporto PF retorna um dos seguintes códigos de status para a solicitação de conjunto de OID de OID_NIC_SWITCH_DELETE_VPORT.

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 de virtualização de E/S 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_DELETE_VPORT_PARAMETERS têm valores inválidos.

NDIS_STATUS_INVALID_LENGTH

O comprimento do buffer de informações é menor que sizeof(NDIS_NIC_SWITCH_DELETE_VPORT_PARAMETERS). O driver de miniporto PF deve definir o data . SET_INFORMATION. BytesNeededed membro 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)

Consulte também


NDIS_NIC_SWITCH_DELETE_VPORT_PARAMETERS

NDIS_OID_REQUEST

NdisCloseAdapterEx

OID_NIC_SWITCH_CREATE_VPORT

OID_NIC_SWITCH_DELETE_SWITCH