estrutura NDIS_SRIOV_CAPABILITIES (ntddndis.h)

Artigo
08/07/2023

A estrutura NDIS_SRIOV_CAPABILITIES especifica os recursos de SR-IOV (virtualização de E/S de raiz única) do adaptador de rede.

Sintaxe

typedef struct _NDIS_SRIOV_CAPABILITIES {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  ULONG              SriovCapabilities;
} NDIS_SRIOV_CAPABILITIES, *PNDIS_SRIOV_CAPABILITIES;

Membros

Header

O tipo, a revisão e o tamanho da estrutura NDIS_SRIOV_CAPABILITIES . Esse membro é formatado como uma estrutura NDIS_OBJECT_HEADER .

O driver de miniporta deve definir o membro Type de Header como NDIS_OBJECT_TYPE_DEFAULT. Para especificar a versão da estrutura NDIS_SRIOV_CAPABILITIES , o driver deve definir o membro Revision de Header para o seguinte valor:

NDIS_SRIOV_CAPABILITIES _REVISION_1

Versão original do NDIS 6.30 e posterior.

Defina o membro Size como NDIS_SIZEOF_SRIOV_CAPABILITIES _REVISION_1.

Flags

Um valor ULONG que contém um OR bit a bit de sinalizadores. Este membro é reservado para NDIS

SriovCapabilities

Um valor ULONG que contém um OR bit a bit dos seguintes sinalizadores:

NDIS_SRIOV_CAPS_SRIOV_SUPPORTED

Especifica que o adaptador de rede dá suporte à funcionalidade SR-IOV.

Nota Esse sinalizador só deve ser definido pelo driver de miniporto para a PF (Função Física) PCI Express (PCIe) do adaptador de rede. Esse driver é executado no sistema operacional de gerenciamento. Esse sistema operacional é executado na partição pai do Hyper-V.

NDIS_SRIOV_CAPS_PF_MINIPORT

Especifica que esse é um driver de miniporta PF.

NDIS_SRIOV_CAPS_VF_MINIPORT

Especifica que este é um driver de miniporta pcie vf (função virtual).

Comentários

O driver de miniporta usa a estrutura NDIS_SRIOV_CAPABILITIES para relatar suas funcionalidades SR-IOV das seguintes maneiras:

O driver de miniporto chama a função NdisMSetMiniportAttributes de sua função MiniportInitializeEx e define o parâmetro MiniportAttributes como um ponteiro para uma estrutura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES . O driver anuncia o suporte a SR-IOV formatando os membros HardwareSriovCapabilities e CurrentSriovCapabilities como estruturas NDIS_SRIOV_CAPABILITIES .
Quando o driver lida com êxito com uma solicitação de consulta OID de OID_SRIOV_HARDWARE_CAPABILITIES ou OID_SRIOV_CURRENT_CAPABILITIES, ele retorna uma estrutura NDIS_SRIOV_CAPABILITIES .

O NDIS passa os recursos SR-IOV do adaptador de rede para drivers excessivamente associados ao adaptador de rede da seguinte maneira:

Quando o NDIS chama uma função FilterAttach de um driver de filtro sobressalente, o NDIS passa os recursos SR-IOV do adaptador de rede por meio do parâmetro AttachParameters . Esse parâmetro contém um ponteiro para uma estrutura NDIS_FILTER_ATTACH_PARAMETERS . O membro SriovCapabilities dessa estrutura contém um ponteiro para uma estrutura NDIS_SRIOV_CAPABILITIES .
Quando o NDIS chama a função ProtocolBindAdapterEx de um driver de protocolo sobreposto, o NDIS passa as funcionalidades SR-IOV do adaptador de rede por meio do parâmetro BindParameters . Esse parâmetro contém um ponteiro para uma estrutura NDIS_FILTER_ATTACH_PARAMETERS . O membro SriovCapabilities dessa estrutura contém um ponteiro para uma estrutura NDIS_SRIOV_CAPABILITIES .