Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O NDIS emite uma solicitação de conjunto OID (identificador de objeto) de OID_NIC_SWITCH_DELETE_SWITCH para excluir um comutador NIC de um adaptador de rede.
O NDIS emite essa solicitação de conjunto de OID para o driver de miniporto da função física PCI Express (PCIe) do adaptador de rede (PF). 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).
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 miniporto PF.
O informationbuffer membro da estrutura NDIS_OID_REQUEST contém um ponteiro para uma estrutura de NDIS_NIC_SWITCH_DELETE_SWITCH_PARAMETERS.
Observações
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 ele recebe a solicitação de método OID de OID_NIC_SWITCH_DELETE_SWITCH, o driver de miniporto PF deve fazer o seguinte:
Se o driver de miniporto PF der suporte à criação estática e à configuração de comutadores NIC, ele deverá liberar os recursos de software associados ao comutador NIC especificado. No entanto, o driver só pode liberar os recursos de hardware para a opção 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.
Se o driver de miniporto PF der suporte à criação dinâmica e à configuração de comutadores NIC, ele deverá liberar os recursos de hardware e software associados ao comutador NIC especificado.
Para obter mais informações sobre a criação dinâmica do comutador NIC, consulte Criação dinâmica de umde comutador NIC.
Se o driver de miniporto PF der suporte à criação dinâmica e todas as opções nic tiverem sido excluídas, 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 Capacidade Estendida no espaço de configuração de PCI do PF do adaptador de rede.
Observação Se o driver de miniporto PF der suporte à criação estática e à configuração de comutadores NIC, ele só deverá chamar NdisMEnableVirtualization quando MiniportHaltEx for chamado.
Para obter mais informações, consulte Excluindo umde comutador NIC.
Códigos de status de retorno
A funçãoMiniportOidRequestdo driver de miniporto retorna um dos seguintes valores para esta solicitação:
| Prazo | Descrição |
|---|---|
NDIS_STATUS_SUCCESS |
O driver de miniporto concluiu a solicitação com êxito. |
NDIS_STATUS_PENDING |
O driver de miniporto concluirá a solicitação de forma assíncrona. Depois que o driver de miniporto tiver concluído todo o processamento, ele deverá ter êxito na solicitação chamando a funçãoNdisMOidRequestComplete, passando NDIS_STATUS_SUCCESS para o parâmetro status do. |
NDIS_STATUS_NOT_ACCEPTED |
O driver de miniporto está sendo redefinido. |
NDIS_STATUS_REQUEST_ABORTED |
O driver de miniporto parou de processar a solicitação. Por exemplo, o NDIS chamou a função MiniportResetEx. |
O NDIS retorna um dos seguintes códigos de status para esta solicitação:
| Prazo | 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 ou não está habilitado para usar a interface. |
NDIS_STATUS_FILE_NOT_FOUND |
Um ou mais 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 de . SET_INFORMATION. BytesNeededed membro na estrutura NDIS_OID_REQUEST para o tamanho mínimo do buffer necessário. |
Requisitos
Versão |
Com suporte no NDIS 6.30 e posterior. |
Cabeçalho |
Ntddndis.h (inclua Ndis.h) |