OID_NIC_SWITCH_DELETE_VPORT
Um driver sobreposto emite uma solicitação de conjunto de 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.
Os drivers em excesso emitem essa solicitação de conjunto de OID para o driver de miniporta para a PF (Função Física PCIe) do adaptador de rede. Essa solicitação de conjunto de 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 a estrutura NDIS_NIC_SWITCH_DELETE_VPORT_PARAMETERS .
Comentários
Um driver de sobreposição, 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.
Nota 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 é excluído implicitamente quando o driver de miniporto PF exclui o comutador NIC padrão. Para obter mais informações, consulte Excluindo um 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 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_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. 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. |
parâmetro |
Ntddndis.h (inclua Ndis.h) |