struktur NDIS_SRIOV_CAPABILITIES (ntddndis.h)

Artikel
08/07/2023

Struktur NDIS_SRIOV_CAPABILITIES menentukan kemampuan virtualisasi I/O root tunggal (SR-IOV) adaptor jaringan.

Sintaks

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

Anggota

Header

Jenis, revisi, dan ukuran struktur NDIS_SRIOV_CAPABILITIES . Anggota ini diformat sebagai struktur NDIS_OBJECT_HEADER .

Driver miniport harus mengatur anggota JenisHeader ke NDIS_OBJECT_TYPE_DEFAULT. Untuk menentukan versi struktur NDIS_SRIOV_CAPABILITIES , driver harus mengatur anggota RevisiHeader ke nilai berikut:

NDIS_SRIOV_CAPABILITIES _REVISION_1

Versi asli untuk NDIS 6.30 dan yang lebih baru.

Atur anggota Ukuran ke NDIS_SIZEOF_SRIOV_CAPABILITIES _REVISION_1.

Flags

Nilai ULONG yang berisi bitwise OR dari bendera. Anggota ini dicadangkan untuk NDIS

SriovCapabilities

Nilai ULONG yang berisi bitwise ATAU dari bendera berikut:

NDIS_SRIOV_CAPS_SRIOV_SUPPORTED

Menentukan bahwa adaptor jaringan mendukung fungsionalitas SR-IOV.

Catatan Bendera ini hanya boleh diatur oleh driver miniport untuk Fungsi Fisik (PF) PCI Express (PCIe) adaptor jaringan. Driver ini berjalan dalam sistem operasi manajemen. Sistem operasi ini berjalan di partisi induk Hyper-V.

NDIS_SRIOV_CAPS_PF_MINIPORT

Menentukan bahwa ini adalah driver miniport PF.

NDIS_SRIOV_CAPS_VF_MINIPORT

Menentukan bahwa ini adalah driver miniport PCIe Virtual Function (VF).

Keterangan

Driver miniport menggunakan struktur NDIS_SRIOV_CAPABILITIES untuk melaporkan kemampuan SR-IOV-nya dengan cara berikut:

Driver miniport memanggil fungsi NdisMSetMiniportAttributes dari fungsi MiniportInitializeEx dan mengatur parameter MiniportAttributes ke penunjuk ke struktur NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES . Driver mengiklankan dukungan SR-IOV dengan memformat anggota HardwareSriovCapabilities dan CurrentSriovCapabilities sebagai struktur NDIS_SRIOV_CAPABILITIES .
Ketika driver berhasil menangani permintaan kueri OID OID_SRIOV_HARDWARE_CAPABILITIES atau OID_SRIOV_CURRENT_CAPABILITIES, driver mengembalikan struktur NDIS_SRIOV_CAPABILITIES .

NDIS meneruskan kemampuan SR-IOV adaptor jaringan ke driver yang terlalu mengikat adaptor jaringan dengan cara berikut:

Ketika NDIS memanggil fungsi FilterAttach driver filter yang terlalu berlebihan, NDIS melewati kemampuan SR-IOV adaptor jaringan melalui parameter AttachParameters . Parameter ini berisi penunjuk ke struktur NDIS_FILTER_ATTACH_PARAMETERS . Anggota SriovCapabilities dari struktur ini berisi penunjuk ke struktur NDIS_SRIOV_CAPABILITIES .
Ketika NDIS memanggil fungsi ProtocolBindAdapterEx driver protokol yang terlalu berlebihan, NDIS melewati kemampuan SR-IOV adaptor jaringan melalui parameter BindParameters . Parameter ini berisi penunjuk ke struktur NDIS_FILTER_ATTACH_PARAMETERS . Anggota SriovCapabilities dari struktur ini berisi penunjuk ke struktur NDIS_SRIOV_CAPABILITIES .