OID_NIC_SWITCH_DELETE_VPORT

Um driver sobreposto emite uma solicitação de conjunto de identificador de objeto (OID) de OID_NIC_SWITCH_DELETE_VPORT excluir uma porta virtual não padrão (VPort) 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 sobrepostos emitem essa solicitação de conjunto OID para o driver de miniporta para a função física PCIe (PF) do adaptador de rede. Essa solicitação de conjunto 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 a estrutura NDIS_NIC_SWITCH_DELETE_VPORT_PARAMETERS.

Comentários

Um driver sobreposto, como um driver de protocolo ou filtro, só pode excluir um VPort não padrão que ele criou 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 miniporta 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 explicitamente excluídos por meio de solicitações OID de OID_NIC_SWITCH_DELETE_VPORT. O VPort padrão é implicitamente excluído quando o driver de miniporta PF exclui o switch NIC padrão. Para obter mais informações, consulte Excluindo um comutador NIC.

Códigos de status de retorno

O driver de miniporta PF retorna um dos seguintes códigos de status para a solicitação de conjunto 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 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_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 miniporta PF deve definir o DATA. SET_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.