OID_SRIOV_VF_VENDOR_DEVICE_ID

Driver yang terlalu berlebihan mengeluarkan permintaan metode pengidentifikasi objek (OID) OID_SRIOV_VF_VENDOR_DEVICE_ID untuk mengkueri pengidentifikasi perangkat PCI Express (PCIe) dan pengidentifikasi vendor (VendorID) untuk adaptor jaringan Fungsi Virtual (VF) PCI Express (PCIe). Adaptor jaringan virtual ini diekspos dalam partisi anak Hyper-V yang melekat pada VF.

Driver yang terlalu mengandalkan mengeluarkan permintaan metode OID ini ke driver miniport fungsi fisik (PF) PCI Express (PCIe) adaptor jaringan. Permintaan metode OID ini diperlukan untuk driver miniport PF yang mendukung antarmuka virtualisasi I/O root tunggal (SR-IOV).

Anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke struktur NDIS_SRIOV_VF_VENDOR_DEVICE_ID_INFO .

Keterangan

Sebelum mengeluarkan permintaan metode OID ini, driver yang terlalu berlebihan harus menginisialisasi struktur NDIS_SRIOV_VF_VENDOR_DEVICE_ID_INFO dan harus mengatur anggota VFId ke pengidentifikasi VF tempat informasi akan dibaca.

Ketika menangani permintaan OID ini, driver miniport PF harus memverifikasi bahwa VF yang ditentukan memiliki sumber daya yang telah dialokasikan sebelumnya. Driver miniport PF mengalokasikan sumber daya untuk VF selama permintaan metode OID OID_NIC_SWITCH_ALLOCATE_VF. Jika sumber daya untuk VF yang ditentukan belum dialokasikan, driver harus gagal dalam permintaan OID.

Untuk informasi selengkapnya, lihat Mengkueri Vendor PCI dan Pengidentifikasi Perangkat untuk Fungsi Virtual.

Mengembalikan Kode Status

Driver miniport PF mengembalikan salah satu kode status berikut untuk permintaan metode OID OID_SRIOV_VF_VENDOR_DEVICE_ID.

Kode Status Deskripsi

NDIS_STATUS_SUCCESS

Permintaan OID berhasil diselesaikan.

NDIS_STATUS_NOT_SUPPORTED

Driver miniport PF tidak mendukung antarmuka virtualisasi I/O root tunggal (SR-IOV) atau tidak diaktifkan untuk menggunakan antarmuka.

NDIS_STATUS_INVALID_PARAMETER

Satu atau beberapa anggota struktur NDIS_SRIOV_VF_VENDOR_DEVICE_ID_INFO memiliki nilai yang tidak valid.

NDIS_STATUS_INVALID_LENGTH

Buffer informasi terlalu pendek. NDIS mengatur DATA. METHOD_INFORMATION. Anggota BytesNeeded dalam struktur NDIS_OID_REQUEST ke ukuran buffer minimum yang diperlukan.

NDIS_STATUS_FAILURE

Permintaan gagal karena alasan lain.

Persyaratan

Versi

Didukung di NDIS 6.30 dan yang lebih baru.

Header

Ntddndis.h (termasuk Ndis.h)

Lihat juga


NDIS_OID_REQUEST

NDIS_SRIOV_VF_VENDOR_DEVICE_ID_INFO

OID_NIC_SWITCH_ALLOCATE_VF