OID_SRIOV_CURRENT_CAPABILITIES

Artikel
06/15/2023

Driver yang terlalu berlebihan mengeluarkan permintaan kueri pengidentifikasi objek (OID) OID_SRIOV_CURRENT_CAPABILITIES untuk mendapatkan kemampuan virtualisasi I/O root tunggal (SR-IOV) saat ini dari adaptor jaringan.

Anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke struktur NDIS_SRIOV_CAPABILITIES .

Keterangan

Dimulai dengan NDIS 6.30, driver miniport menyediakan kemampuan perangkat keras SR-IOV yang diaktifkan pada adaptor jaringan ketika fungsi MiniportInitializeEx-nya dipanggil. Driver menginisialisasi struktur NDIS_SRIOV_CAPABILITIES dengan kemampuan perangkat keras SR-IOV yang saat ini diaktifkan dan mengatur anggota CurrentSriovCapabilities dari struktur NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES ke penunjuk ke struktur NDIS_SRIOV_CAPABILITIES . Driver miniport kemudian memanggil fungsi NdisMSetMiniportAttributes dan mengatur parameter MiniportAttributes ke penunjuk ke struktur NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES .

Protokol yang terlalu berlebihan dan driver filter tidak perlu mengeluarkan permintaan kueri OID OID_SRIOV_CURRENT_CAPABILITIES. NDIS menyediakan kemampuan SR-IOV yang saat ini diaktifkan dari adaptor jaringan ke driver ini dengan cara berikut:

NDIS melaporkan kemampuan SR-IOV yang saat ini diaktifkan dari adaptor jaringan yang mendasarinya ke driver protokol yang terlalu berlebihan di anggota SriovCapabilities dari struktur NDIS_BIND_PARAMETERS selama operasi pengikatan.
NDIS melaporkan kemampuan SR-IOV yang saat ini diaktifkan dari adaptor jaringan yang mendasarinya ke driver filter yang terlalu berlebihan di anggota SriovCapabilities dari struktur NDIS_FILTER_ATTACH_PARAMETERS selama operasi lampirkan.

Mengembalikan Kode Status

NDIS menangani permintaan kueri OID dari permintaan OID_SRIOV_CURRENT_CAPABILITIES untuk driver miniport. Driver tidak akan dikeluarkan permintaan OID ini.

Saat NDIS menangani permintaan OID_SRIOV_CURRENT_CAPABILITIES, 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_LENGTH	Buffer informasi terlalu pendek. Driver miniport harus mengatur DATA. QUERY_INFORMATION. Anggota BytesNeeded dalam struktur NDIS_OID_REQUEST ke ukuran buffer minimum yang diperlukan.
NDIS_STATUS_FAILURE	Permintaan gagal karena alasan lain.