OID_SRIOV_BAR_RESOURCES

O NDIS emite uma solicitação de método OID (identificador de objeto) de OID_SRIOV_BAR_RESOURCES para determinar os recursos de memória que foram alocados para um REGISTRO de Endereço Base (BAR) PCI Express (PCIe) de uma função virtual PCIe (VF).

O NDIS emite essa solicitação de método OID para o driver de miniporto para a PF (Função Física PCIe) do adaptador de rede. Essa solicitação de método OID é necessária para drivers de miniporta PF que dão suporte à interface SR-IOV (virtualização de E/S de raiz única).

O membro InformationBuffer da estrutura NDIS_OID_REQUEST contém um ponteiro para um buffer. Esse buffer contém as seguintes estruturas:

• Uma estrutura NDIS_SRIOV_BAR_RESOURCES_INFO que especifica o VF e a BARRA para os quais o driver de miniporto PF retorna informações de recurso.

• Uma estrutura CM_PARTIAL_RESOURCE_DESCRIPTOR que segue a estrutura NDIS_SRIOV_BAR_RESOURCES_INFO . A estrutura CM_PARTIAL_RESOURCE_DESCRIPTOR contém informações sobre os recursos de memória que foram alocados para a BARRA especificada.

Comentários

O NDIS emite uma solicitação de método OID de OID_SRIOV_BAR_RESOURCES para obter o endereço físico do sistema e o comprimento dos recursos de memória que foram alocados para uma BARRA de VF. Antes de emitir a solicitação do método OID, o NDIS formata a estrutura NDIS_SRIOV_BAR_RESOURCES_INFO da seguinte maneira:

• O NDIS define o membro VFId da estrutura NDIS_SRIOV_BAR_RESOURCES_INFO para o identificador associado ao VF.

• O NDIS define o membro BarIndex da estrutura NDIS_SRIOV_BAR_RESOURCES_INFO para o índice BAR do VF especificado. O índice BAR é o deslocamento do registro dentro da tabela de BARs no espaço de configuração de PCI.

• O NDIS define o membro BarResourcesOffset da estrutura NDIS_SRIOV_BAR_RESOURCES_INFO como o deslocamento, em unidades de bytes, desde o início da estrutura NDIS_SRIOV_BAR_RESOURCES_INFO até uma estrutura CM_PARTIAL_RESOURCE_DESCRIPTOR .

Nota Drivers sobrepostos, como drivers de protocolo ou filtro, não podem emitir solicitações de método OID de OID_SRIOV_BAR_RESOURCES para o driver de miniporto PF.

Quando o driver de miniporto PF recebe a solicitação do método OID, o driver retorna os recursos para a BARRA especificada formatando a estrutura CM_PARTIAL_RESOURCE_DESCRIPTOR dentro do membro InformationBuffer da estrutura NDIS_OID_REQUEST . O driver formata a estrutura CM_PARTIAL_RESOURCE_DESCRIPTOR com os recursos de hardware do sistema associados à BARRA do VF especificado.

Nota O driver deve formatar a estrutura para um tipo de recurso de CmResourceTypeMemory.

Códigos de status de retorno

O driver de miniporto PF retorna um dos seguintes códigos de status para a solicitação de método de OID_SRIOV_BAR_RESOURCES.

Código de status	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 (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_SRIOV_BAR_RESOURCES_INFO têm valores inválidos.
NDIS_STATUS_INVALID_LENGTH	O buffer de informações é menor que (sizeof(NDIS_SRIOV_BAR_RESOURCES_INFO) + sizeof(CM_PARTIAL_RESOURCE_DESCRIPTOR). O driver de miniporto PF deve definir o DATA. 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.

Requisitos

Versão	Com suporte no NDIS 6.30 e posterior.
parâmetro	Ntddndis.h (inclua Ndis.h)

Confira também

---

CM_PARTIAL_RESOURCE_DESCRIPTOR

NDIS_OID_REQUEST

NDIS_SRIOV_BAR_RESOURCES_INFO