GET_VIRTUAL_DEVICE_DATA fungsi panggilan balik (wdm.h)

Artikel
02/27/2024

Rutinitas GetVirtualFunctionData membaca data dari ruang konfigurasi PCI Express (PCIe) fungsi virtual (VF) pada perangkat yang mendukung antarmuka virtualisasi I/O root tunggal (SR-IOV).

Sintaks

GET_VIRTUAL_DEVICE_DATA GetVirtualDeviceData;

ULONG GetVirtualDeviceData(
  [in, out] PVOID Context,
  [in]      USHORT VirtualFunction,
  [out]     PVOID Buffer,
  [in]      ULONG Offset,
  [in]      ULONG Length
)
{...}

Parameter

[in, out] Context

Penunjuk ke informasi konteks khusus antarmuka. Pemanggil meneruskan nilai yang diteruskan sebagai anggota Konteks dari struktur PCI_VIRTUALIZATION_INTERFACE untuk antarmuka.

[in] VirtualFunction

Nilai berbasis nol yang menentukan VF pada perangkat tempat data akan dibaca.

[out] Buffer

Penunjuk ke buffer yang berisi informasi konfigurasi yang dibaca dari ruang konfigurasi PCIe VF.

[in] Offset

Offset ke dalam data ruang konfigurasi PCIe VF. Anggota ini menentukan di mana operasi baca ini dimulai.

[in] Length

Panjangnya, dalam byte, dari data yang akan dibaca.

Nilai kembali

Rutinitas GetVirtualFunctionData mengembalikan panjang, dalam byte, dari data konfigurasi PCIe yang dibaca setelah operasi baca berhasil. Jika operasi baca tidak berhasil, rutinitas mengembalikan nol.

Keterangan

Rutinitas GetVirtualFunctionData menyerupai rutinitas GetBusData , kecuali bahwa ia membaca data konfigurasi PCIe dari VF alih-alih dari fungsi fisik perangkat (PF).

Rutinitas GetVirtualFunctionData disediakan oleh antarmuka GUID_PCI_VIRTUALIZATION_INTERFACE . Rutinitas GetBusData disediakan oleh antarmuka GUID_BUS_INTERFACE_STANDARD .

Tumpukan virtualisasi memanggil GetVirtualFunctionData ketika driver yang berjalan di sistem operasi tamu memanggil rutinitas GetBusData .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung di Windows Server 2012 dan versi Windows yang lebih baru.
Target Platform	Desktop
Header	wdm.h (termasuk Wdm.h)
IRQL	IRQL <= APC_LEVEL

Lihat juga

PCI_VIRTUALIZATION_INTERFACE

GetBusData