Fungsi NdisMWriteConfigBlock (ndis.h)

Artikel
08/07/2023

Driver miniport untuk Fungsi Virtual (VF) PCI Express (PCIe) memanggil fungsi NdisMWriteConfigBlock untuk menulis data ke blok konfigurasi VF. Operasi tulis pada blok konfigurasi VF ditangani oleh driver miniport dari PCIe Physical Function (PF) adaptor jaringan.

CatatanNdisMWriteConfigBlock hanya boleh dipanggil oleh driver miniport untuk VF adaptor jaringan.

Sintaks

NDIS_STATUS NdisMWriteConfigBlock(
  [in] NDIS_HANDLE NdisMiniportHandle,
  [in] ULONG       BlockId,
  [in] PVOID       Buffer,
  [in] ULONG       Length
);

Parameter

[in] NdisMiniportHandle

Adaptor jaringan menangani bahwa NDIS diteruskan ke parameter MiniportAdapterHandle dari MiniportInitializeEx.

[in] BlockId

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

[in] Buffer

Penunjuk ke buffer yang dialokasikan penelepon yang berisi data konfigurasi yang akan ditulis.

[in] Length

Jumlah byte yang akan ditulis ke blok konfigurasi.

Nilai kembali

NdisMWriteConfigBlock dapat mengembalikan salah satu nilai status berikut.

Menampilkan kode	Deskripsi
NDIS_STATUS_SUCCESS	Operasi tulis berhasil diselesaikan.
NDIS_STATUS_FAILURE	Operasi tulis gagal.

Keterangan

Driver miniport VF memanggil NdisMWriteConfigBlock untuk memulai permintaan penulisan backchannel data konfigurasi VF oleh driver miniport PF. Setelah diberi tahu tentang permintaan ini, driver PF menulis data ke blok konfigurasi VF yang ditentukan.

Blok konfigurasi VF digunakan untuk komunikasi backchannel antara driver miniport PF dan VF. IHV dapat menentukan satu atau beberapa blok konfigurasi VF untuk perangkat. Setiap blok konfigurasi VF memiliki format, panjang, dan ID blok yang ditentukan IHV.

Catatan Data dari setiap blok konfigurasi VF 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.

Interfacing ke Virtual Bus Driver

Jika vendor perangkat keras independen (IHV) menyediakan driver bus virtual (VBD) sebagai bagian dari paket driver SR-IOV, driver miniportnya tidak boleh memanggil NdisMWriteConfigBlock. Sebagai gantinya, driver harus berinteraksi dengan VBD melalui saluran komunikasi privat, dan meminta agar VBD memanggil WriteVfConfigBlock. Fungsi ini diekspos dari antarmuka GUID_VPCI_INTERFACE_STANDARD yang didukung oleh driver bus PCI virtual (VPCI) yang mendasar.

VBD yang berjalan dalam sistem operasi tamu partisi anak Hyper-V dapat meminta antarmuka GUID_VPCI_INTERFACE_STANDARD dengan mengeluarkan permintaan IRP_MN_QUERY_INTERFACE ke objek perangkat fisik (PDO) pada bus VPCI. Permintaan ini harus dibuat dari IRQL = PASSIVE_LEVEL. Dalam permintaan ini, driver harus mengatur parameter InterfaceType ke GUID_VPCI_INTERFACE_STANDARD.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tidak ada yang didukung, Didukung di NDIS 6.30 dan yang lebih baru.
Server minimum yang didukung	Windows Server 2012
Target Platform	Universal
Header	ndis.h (termasuk Ndis.h)
Pustaka	Ndis.lib
IRQL	<= APC_LEVEL

Lihat juga

GUID_VPCI_INTERFACE_STANDARD

WriteVfConfigBlock

Share via