OID_NIC_SWITCH_DELETE_SWITCH

Artigo
06/15/2023

O NDIS emite uma solicitação de conjunto de 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 miniporte da PF (Função Física) PCI Express (PCIe) do adaptador de rede. Essa solicitação de conjunto de OID é necessária para drivers de miniporte PF que dão suporte à interface sr-IOV (virtualização de E/S) raiz única.

Nota 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 membro InformationBuffer 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 de 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 à opção NIC especificada. 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 à opção NIC especificada.

Para obter mais informações sobre a criação dinâmica do comutador NIC, consulte Criação dinâmica de um 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 bit Habilitar VF na estrutura capacidade estendida SR-IOV no espaço de configuração PCI do PF do adaptador de rede.

Nota 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 um comutador NIC.

Retornar códigos de status

A função MiniportOidRequest do driver de miniport retorna um dos seguintes valores para esta solicitação:

Termo	Descrição
NDIS_STATUS_SUCCESS	O driver de miniporte concluiu a solicitação com êxito.
NDIS_STATUS_PENDING	O driver de miniporte 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ção NdisMOidRequestComplete , passando NDIS_STATUS_SUCCESS para o parâmetro Status .
NDIS_STATUS_NOT_ACCEPTED	O driver de miniporte 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:

Termo	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 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. Membro BytesNeeded na estrutura NDIS_OID_REQUEST para o tamanho mínimo do buffer necessário.