OID_NIC_SWITCH_VF_PARAMETERS

Artigo
06/15/2023

Um driver ou aplicativo de modo de usuário emite uma solicitação de método OID (identificador de objeto) de OID_NIC_SWITCH_VF_PARAMETERS para obter os parâmetros de configuração atuais de uma VF (Função Virtual) PCI Express (PCIe) em um adaptador de rede. Somente as VFs que têm recursos alocados por meio de uma solicitação de método OID de OID_NIC_SWITCH_ALLOCATE_VF podem ser consultadas por meio de uma solicitação de método OID de OID_NIC_SWITCH_VF_PARAMETERS.

O NDIS manipula a solicitação de método OID de OID_NIC_SWITCH_VF_PARAMETERS para drivers de miniporta.

Quando a solicitação do método OID é feita, o membro InformationBuffer da estrutura NDIS_OID_REQUEST contém um ponteiro para uma estrutura NDIS_NIC_SWITCH_VF_PARAMETERS .

Comentários

O driver sobreposto ou o aplicativo de modo de usuário especifica o VF a ser consultado definindo o membro VFId da estrutura NDIS_NIC_SWITCH_VF_PARAMETERS para o identificador do VF. O driver ou aplicativo de sobreposição obtém o identificador VF por meio de uma das seguintes maneiras:

Emitindo uma solicitação de método OID de OID_NIC_SWITCH_ENUM_VFS.

Se essa solicitação OID for concluída com êxito, o driver ou aplicativo de modo de usuário excessivamente receberá uma lista de todos os VFs alocados no adaptador de rede. Cada elemento dentro da lista é uma estrutura NDIS_NIC_SWITCH_VF_INFO , com o identificador de VF especificado pelo membro VFId .
Emitindo uma solicitação de método OID de OID_NIC_SWITCH_ALLOCATE_VF.

Se essa solicitação OID for concluída com êxito, o driver sobreposto receberá o identificador do VF recém-criado no membro VFId da estrutura de NDIS_NIC_SWITCH_VF_PARAMETERS retornada.

Nota Somente drivers de sobreposição podem obter o identificador de VF dessa maneira.

Após um retorno bem-sucedido da solicitação do método OID, o membro InformationBuffer da estrutura NDIS_OID_REQUEST contém um ponteiro para uma estrutura NDIS_NIC_SWITCH_VF_PARAMETERS . Essa estrutura contém os parâmetros de configuração para o VF especificado.

Códigos de status de retorno

O NDIS manipula a solicitação de método OID de OID_NIC_SWITCH_VF_PARAMETERS para drivers de miniporto e retorna o código status a seguir para solicitações de método OID de OID_NIC_SWITCH_VF_PARAMETERS.

Código de status	Descrição
NDIS_STATUS_SUCCESS	A solicitação foi concluída com êxito. O membro InformationBuffer aponta para uma estrutura NDIS_NIC_SWITCH_VF_PARAMETERS .
NDIS_STATUS_NOT_SUPPORTED	O driver de miniporta 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_VF_PARAMETERS têm valores inválidos.
NDIS_STATUS_INVALID_LENGTH	O comprimento do buffer de informações é menor que sizeof(NDIS_NIC_SWITCH_VF_PARAMETERS). O NDIS define os DADOS. METHOD_INFORMATION. Membro BytesNeeded na estrutura NDIS_OID_REQUEST para o tamanho mínimo do buffer necessário.
NDIS_STATUS_INVALID_LENGTH	O buffer de informações era muito curto. O NDIS define os DADOS. METHOD_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.