SET_VIRTUAL_DEVICE_DATA fungsi panggilan balik (wdm.h)

  • Artikel

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

Sintaks

SET_VIRTUAL_DEVICE_DATA SetVirtualDeviceData;

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

Parameter

[in, out] Context

Penunjuk ke informasi konteks khusus antarmuka. Penelepon 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 ditulis.

[in] Buffer

Penunjuk ke buffer yang berisi informasi konfigurasi yang akan ditulis ke ruang konfigurasi PCIe VF.

[in] Offset

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

[in] Length

Panjang, dalam byte, dari data yang akan ditulis.

Nilai kembali

Rutinitas *SetVirtualFunctionData mengembalikan panjang, dalam byte, dari data konfigurasi PCIe yang ditulis setelah operasi penulisan berhasil. Jika operasi tulis tidak berhasil, rutinitas mengembalikan nol.

Keterangan

Rutinitas *SetVirtualFunctionData mirip dengan rutinitas SetBusData , kecuali bahwa ia menulis data konfigurasi PCIe ke VF alih-alih ke fungsi fisik (PF) perangkat.

Rutinitas *SetVirtualFunctionData disediakan oleh antarmuka GUID_PCI_VIRTUALIZATION_INTERFACE . Rutinitas SetBusData disediakan oleh antarmuka GUID_BUS_INTERFACE_STANDARD .

Tumpukan virtualisasi memanggil *SetVirtualFunctionData saat driver yang berjalan di sistem operasi tamu memanggil rutinitas SetBusData .

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

SetBusData

PCI_VIRTUALIZATION_INTERFACE