Partilhar via


OID_NIC_SWITCH_DELETE_SWITCH

O NDIS emite uma solicitação de conjunto de identificador de objeto (OID) de OID_NIC_SWITCH_DELETE_SWITCH excluir um comutador NIC de um adaptador de rede.

O NDIS emite essa solicitação de conjunto OID para o driver de miniporta da função física (PF) PCI Express (PCIe) 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).

Observação Drivers sobrepostos, como drivers de protocolo ou filtro, não podem emitir essa solicitação de método OID para o driver de miniporta PF.

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

Comentários

Uma solicitação de conjunto OID de OID_NIC_SWITCH_DELETE_SWITCH exclui um comutador NIC que foi criado anteriormente por meio de uma solicitação de método OID de OID_NIC_SWITCH_CREATE_SWITCH.

Quando recebe a solicitação do método OID de OID_NIC_SWITCH_DELETE_SWITCH, o driver de miniporta PF deve fazer o seguinte:

  1. Se o driver de miniporta PF suportar a criação estática e a configuração de switches NIC, ele deverá liberar os recursos de software associados ao switch NIC especificado. No entanto, o driver só pode liberar os recursos de hardware para o switch NIC quando MiniportHaltEx é chamado.

    Para obter mais informações sobre a criação de comutador NIC estático, consulte criação estática de um comutador NIC.

  2. Se o driver de miniporta PF suportar a criação dinâmica e a configuração de switches NIC, ele deverá liberar os recursos de hardware e software associados ao switch NIC especificado.

    Para obter mais informações sobre a criação de comutadores NIC dinâmicos, consulte criação dinâmica de um comutador NIC.

  3. Se o driver de miniporta PF suportar a criação dinâmica e todos os comutadores NIC tiverem sido excluídos, o driver deverá desabilitar a virtualização no adaptador chamando NdisMEnableVirtualization. Para desabilitar a virtualização, o adaptador de rede deve definir o parâmetro EnableVirtualization como FALSE e o parâmetro NumVFs como zero.

    NdisMEnableVirtualization limpa o membro NumVFs e o VF Enable bit na estrutura SR-IOV Extended Capability no espaço de configuração PCI do PF do adaptador de rede.

    Observação Se o driver de miniporta PF oferecer suporte à criação estática e configuração de switches NIC, ele só deverá chamar NdisMEnableVirtualization quando MiniportHaltEx for chamado.

Para obter mais informações, consulte Excluindo um comutador NIC.

Códigos de status de retorno

A funçãoMiniportOidRequest do driver de miniportaretorna um dos seguintes valores para essa solicitação:

Vigência Descrição

NDIS_STATUS_SUCCESS

O driver da miniporta concluiu a solicitação com êxito.

NDIS_STATUS_PENDING

O driver de miniporta concluirá a solicitação de forma assíncrona. Depois que o driver de miniporta tiver concluído todo o processamento, ele deverá executar a solicitação chamando a função NdisMOidRequestComplete e passando NDIS_STATUS_SUCCESS para o parâmetro Status .

NDIS_STATUS_NOT_ACCEPTED

O driver da miniporta está sendo redefinido.

NDIS_STATUS_REQUEST_ABORTED

O driver da miniporta parou de processar a solicitação. Por exemplo, o NDIS chamou a funçãoMiniportResetEx.

O NDIS retorna um dos seguintes códigos de status para essa solicitação:

Vigência 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 SR-IOV ou não está habilitado para usar a interface.

NDIS_STATUS_FILE_NOT_FOUND

Um ou mais dos membros da estrutura NDIS_NIC_SWITCH_DELETE_SWITCH_PARAMETERS têm valores inválidos.

NDIS_STATUS_INVALID_LENGTH

O buffer de informações é muito pequeno. O NDIS define os DADOS. SET_INFORMATION. BytesNeeded membro na estrutura NDIS_OID_REQUEST para o tamanho mínimo de buffer necessário.

Requerimentos

Versão

Suportado no NDIS 6.30 e posterior.

Cabeçalho

Ntddndis.h (inclui Ndis.h)

Ver também


MiniportHaltEx

NDIS_OID_REQUEST

NDIS_NIC_SWITCH_DELETE_SWITCH_PARAMETERS

OID_NIC_SWITCH_ALLOCATE_VF

OID_NIC_SWITCH_CREATE_SWITCH

OID_NIC_SWITCH_DELETE_VPORT

OID_NIC_SWITCH_FREE_VF