struktur NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS (ntddndis.h)

Artikel
08/07/2023

Struktur NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS menentukan parameter untuk operasi tulis pada blok konfigurasi Fungsi Virtual (VF) PCI Express (PCIe) adaptor jaringan. Parameter ini digunakan untuk komunikasi backchannel antara VF dan driver miniport PCIe Physical Function (PF).

Sintaks

typedef struct _NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS {
  NDIS_OBJECT_HEADER     Header;
  NDIS_SRIOV_FUNCTION_ID VFId;
  ULONG                  BlockId;
  ULONG                  Length;
  ULONG                  BufferOffset;
} NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS, *PNDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS;

Anggota

Header

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

Driver harus mengatur tipe anggotaHeader ke NDIS_OBJECT_TYPE_DEFAULT. Untuk menentukan versi struktur NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS , driver harus mengatur anggota RevisiHeader ke nilai berikut:

NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS_REVISION_1

Versi asli untuk NDIS 6.30 dan yang lebih baru.

Atur anggota Ukuran ke NDIS_SIZEOF_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS_REVISION_1.

VFId

Nilai NDIS_SRIOV_FUNCTION_ID yang menentukan pengidentifikasi unik VF pada adaptor jaringan.

Catatan VF dengan nilai NDIS_SRIOV_FUNCTION_ID yang ditentukan harus memiliki sumber daya yang sebelumnya dialokasikan melalui permintaan metode pengidentifikasi objek (OID) OID_NIC_SWITCH_ALLOCATE_VF.

BlockId

Nilai ULONG yang menentukan pengidentifikasi blok konfigurasi VF yang akan ditulis. Pengidentifikasi ini milik vendor perangkat keras independen (IHV) dan hanya digunakan oleh driver miniport untuk PF dan VF pada adaptor jaringan.

Untuk informasi lebih lanjut, lihat bagian Keterangan.

Length

Nilai ULONG yang menentukan panjang, dalam satuan byte, dari operasi tulis.

BufferOffset

Nilai ULONG yang menentukan offset, dalam satuan byte, dari awal struktur ini hingga buffer yang berisi data yang akan ditulis ke blok konfigurasi VF yang ditentukan.

Keterangan

Struktur NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS digunakan dalam permintaan set OID_SRIOV_WRITE_VF_CONFIG_BLOCK OID.

Blok konfigurasi VF digunakan untuk komunikasi backchannel antara driver PCIe PF dan VF pada perangkat yang mendukung antarmuka SR-IOV. Data dari blok konfigurasi VF dapat dipertukarkan antara driver berikut:

Driver miniport VF, yang berjalan dalam sistem operasi tamu. Sistem operasi ini berjalan dalam partisi anak Hyper-V.
Driver miniport PF, yang berjalan dalam sistem operasi manajemen.
Sistem operasi ini berjalan dalam partisi induk Hyper-V.

Catatan Penggunaan blok konfigurasi VF dan format data konfigurasinya ditentukan oleh vendor perangkat keras independen (IHV) perangkat. Data konfigurasi hanya digunakan oleh driver miniport PF dan VF.

Untuk informasi selengkapnya tentang komunikasi backchannel dalam antarmuka virtualisasi I/O root tunggal (SR-IOV), lihat Komunikasi Backchannel SR-IOV PF/VF.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung di NDIS 6.30 dan yang lebih baru.
Header	ntddndis.h (termasuk Ndis.h)

Lihat juga

NDIS_OBJECT_HEADER

OID_SRIOV_WRITE_VF_CONFIG_BLOCK

Share via