OID_NIC_SWITCH_ENUM_VFS
Driver yang terlalu besar atau aplikasi mode pengguna mengeluarkan permintaan metode pengidentifikasi objek (OID) OID_NIC_SWITCH_ENUM_VFS untuk mendapatkan array. Setiap elemen dalam array menentukan atribut Fungsi Virtual (VF) PCI Express (PCIe) yang dilampirkan ke sakelar NIC pada sakelar NIC adaptor jaringan.
Setelah pengembalian berhasil dari permintaan kueri OID ini, anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke buffer yang berisi berikut ini:
Struktur NDIS_NIC_SWITCH_VF_INFO_ARRAY yang menentukan jumlah elemen dalam array.
Array struktur NDIS_NIC_SWITCH_VF_INFO . Masing-masing struktur ini berisi informasi tentang satu VF pada sakelar NIC adaptor jaringan. VF dilampirkan ke sakelar NIC melalui permintaan metode OID OID_NIC_SWITCH_ALLOCATE_VF.
Catatan Jika tidak ada VF yang dilampirkan ke sakelar NIC pada adaptor jaringan, anggota NumElements dari struktur NDIS_NIC_SWITCH_VF_INFO_ARRAY diatur ke nol dan tidak ada struktur NDIS_NIC_SWITCH_VF_INFO yang dikembalikan.
Keterangan
Driver yang terlalu banyak dan aplikasi mode pengguna mengeluarkan permintaan metode OID OID_NIC_SWITCH_ENUM_VFS untuk menghitung VF yang terpasang pada sakelar NIC adaptor jaringan.
Sebelum driver atau aplikasi mengeluarkan permintaan OID, itu harus menginisialisasi struktur NDIS_NIC_SWITCH_VF_INFO_ARRAY yang diteruskan bersama dengan permintaan. Driver atau aplikasi harus mengikuti panduan ini saat menginisialisasi struktur NDIS_NIC_SWITCH_VF_INFO_ARRAY :
Jika bendera NDIS_NIC_SWITCH_VF_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH diatur dalam anggota Bendera , driver atau aplikasi harus mengatur anggota SwitchId ke pengidentifikasi sakelar NIC pada adaptor jaringan SR-IOV. Dengan mengatur anggota ini dengan cara ini, informasi VF dikembalikan hanya untuk sakelar NIC yang ditentukan pada adaptor jaringan SR-IOV.
Catatan Driver yang terlalu besar dan aplikasi mode pengguna dapat memperoleh pengidentifikasi sakelar NIC dengan mengeluarkan permintaan kueri OID OID_NIC_SWITCH_ENUM_SWITCHES.
Jika anggota Bendera diatur ke nol, driver atau aplikasi harus mengatur anggota SwitchId ke nol. Dengan mengatur anggota ini dengan cara ini, informasi VF dikembalikan untuk semua sakelar NIC pada adaptor jaringan SR-IOV.
Catatan Dimulai dengan Windows Server 2012, Windows hanya mendukung sakelar NIC default pada adaptor jaringan. Terlepas dari bendera yang diatur dalam anggota Bendera , anggota SwitchId harus diatur ke NDIS_DEFAULT_SWITCH_ID.
Untuk informasi selengkapnya tentang sakelar NIC, lihat Sakelar NIC.
Mengembalikan Kode Status
NDIS menangani permintaan metode OID dari permintaan OID_NIC_SWITCH_ENUM_VFS untuk driver miniport. Driver tidak akan dikeluarkan permintaan OID ini.
Saat NDIS menangani permintaan OID_NIC_SWITCH_ENUM_VFS, NDIS mengembalikan salah satu kode status berikut.
Kode Status | Deskripsi |
---|---|
NDIS_STATUS_SUCCESS |
Permintaan OID berhasil diselesaikan. |
NDIS_STATUS_NOT_SUPPORTED |
Driver miniport 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_NIC_SWITCH_VF_INFO_ARRAY 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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk