OID_NIC_SWITCH_VF_PARAMETERS

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

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

Quando a solicitação do método OID é feita, o InformationBuffer membro 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 VFId membro da estrutura NDIS_NIC_SWITCH_VF_PARAMETERS como o identificador do VF. O driver ou aplicativo sobrejacente obtém o identificador VF por meio de uma das seguintes maneiras:

Ao emitir 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 sobreposto ou o aplicativo de modo de usuário 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 VF especificado pelo membro VFId.
Ao emitir 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 VFId membro da estrutura de NDIS_NIC_SWITCH_VF_PARAMETERS retornada.

Nota Somente drivers sobrepostos podem obter o identificador VF dessa maneira.

Após um retorno bem-sucedido da solicitação do método OID, o InformationBuffer membro 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 lida com a solicitação de método OID de OID_NIC_SWITCH_VF_PARAMETERS para drivers de miniporta e retorna o seguinte código de status 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 suporta a interface de virtualização de E/S de raiz única (SR-IOV) 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. BytesNeeded membro na estrutura NDIS_OID_REQUEST para o tamanho mínimo de buffer necessário.
NDIS_STATUS_INVALID_LENGTH	O buffer de informações era muito curto. O NDIS define os DADOS. METHOD_INFORMATION. BytesNeeded membro na estrutura NDIS_OID_REQUEST para o tamanho mínimo de buffer necessário.
NDIS_STATUS_FAILURE	O pedido foi rejeitado por outros motivos.