NDIS_SRIOV_CAPABILITIES estrutura (ntddndis.h)

Artigo
02/07/2025

A estrutura de NDIS_SRIOV_CAPABILITIES especifica os recursos de virtualização de E/S raiz única (SR-IOV) 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 miniporto deve definir o membro tipo do de cabeçalho para NDIS_OBJECT_TYPE_DEFAULT. Para especificar a versão da estrutura de NDIS_SRIOV_CAPABILITIES, o driver deve definir o membro de Revisão do de Cabeçalho para o seguinte valor:

NDIS_SRIOV_CAPABILITIES _REVISION_1

Versão original do NDIS 6.30 e posterior.

Defina o membro tamanho 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.

Observação Esse sinalizador só deve ser definido pelo driver de miniporto para a 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 Hyper-V.

NDIS_SRIOV_CAPS_PF_MINIPORT

Especifica que este é um driver de miniporto PF.

NDIS_SRIOV_CAPS_VF_MINIPORT

Especifica que este é um driver de miniporto de função virtual (VF) PCIe.

Observações

O driver de miniporto usa a estrutura NDIS_SRIOV_CAPABILITIES para relatar seus recursos de 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 SR-IOV suporte formatando os HardwareSriovCapabilities e CurrentSriovCapabilities membros 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 de SR-IOV do adaptador de rede para drivers excessivamente associados ao adaptador de rede da seguinte maneira:

Quando o NDIS chama a função filterAttach de um driver de filtro sobressalente, o NDIS passa os recursos de SR-IOV do adaptador de rede por meio do parâmetro AttachParameters. Esse parâmetro contém um ponteiro para uma estrutura de 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, o NDIS passa os recursos de SR-IOV do adaptador de rede por meio do parâmetro BindParameters. Esse parâmetro contém um ponteiro para uma estrutura de NDIS_FILTER_ATTACH_PARAMETERS. O membro SriovCapabilities dessa estrutura contém um ponteiro para uma estrutura NDIS_SRIOV_CAPABILITIES.