OID_NIC_SWITCH_VF_PARAMETERS
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 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 manipula a solicitação do método OID de OID_NIC_SWITCH_VF_PARAMETERS para drivers de miniporto.
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.
Observações
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 para o identificador do VF. O driver ou aplicativo em excesso 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 em excesso 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 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 VFId membro da estrutura de NDIS_NIC_SWITCH_VF_PARAMETERS retornada.
Observação Somente drivers subjacentes 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 manipula a solicitação de método OID de OID_NIC_SWITCH_VF_PARAMETERS para drivers de miniporto e retorna o código de 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 do InformationBuffer aponta para uma estrutura de NDIS_NIC_SWITCH_VF_PARAMETERS. |
NDIS_STATUS_NOT_SUPPORTED |
O driver de miniporto não dá suporte à interface de virtualização de E/S 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 de . METHOD_INFORMATION. BytesNeededed membro 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 de . METHOD_INFORMATION. BytesNeededed membro na estrutura NDIS_OID_REQUEST para o tamanho mínimo do buffer necessário. |
NDIS_STATUS_FAILURE |
A solicitação falhou por outros motivos. |
Requisitos
Versão |
Com suporte no NDIS 6.30 e posterior. |
Cabeçalho |
Ntddndis.h (inclua Ndis.h) |