OID_GEN_ISOLATION_PARAMETERS

Artikel
06/15/2023

NDIS dan driver yang terlalu berlebihan mengeluarkan permintaan pengidentifikasi objek (OID) OID_GEN_ISOLATION_PARAMETERS untuk mendapatkan parameter konfigurasi multi-penyewaan (isolasi) yang diatur pada port adaptor jaringan VM.

Meskipun setiap domain perutean dikonfigurasi secara terpisah pada port, OID ini mengembalikan parameter untuk semua domain perutean dalam satu kueri.

Driver yang terlalu berlebihan harus mengeluarkan OID ini dalam dua langkah:

Io mengkueri ukuran buffer yang diperlukan, menerbitkan kueri OID dengan anggota Ukuran anggota Header dari struktur NDIS_ISOLATION_PARAMETERS diatur ke NDIS_SIZEOF_NDIS_ISOLATION_PARAMETERS_REVISION_1. (Lihat NDIS_STATUS_INVALID_LENGTH di bawah ini.)
Terbitkan OID dengan InformationBuffer dengan ukuran yang diperlukan.

Jika permintaan kueri OID berhasil diselesaikan, anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke buffer. Buffer ini berisi data berikut, secara berurutan:

Struktur NDIS_ISOLATION_PARAMETERS
Satu atau beberapa struktur NDIS_ROUTING_DOMAIN_ENTRY , satu untuk setiap domain perutean
Satu atau beberapa struktur NDIS_ROUTING_DOMAIN_ISOLATION_ENTRY , dikelompokkan menurut domain perutean

Dalam setiap struktur NDIS_ROUTING_DOMAIN_ENTRY , anggota FirstIsolationInfoEntryOffset berisi offset dari awal buffer informasi OID (yaitu, awal buffer yang ditujukan anggota InformationBuffer dari struktur NDIS_OID_REQUEST ) ke NDIS_ROUTING_DOMAIN_ISOLATION_ENTRY pertama untuk domain perutean tersebut. Offset di anggota NextIsolationInfoEntryOffset dari struktur terakhir dalam daftar adalah nol.

Jika tidak ada parameter konfigurasi multipenyewa yang diatur pada adaptor jaringan VM, driver miniport adaptor jaringan mengatur DATA. QUERY_INFORMATION. Anggota BytesWritten dari struktur NDIS_OID_REQUEST menjadi nol dan mengembalikan NDIS_STATUS_SUCCESS. Dalam hal ini, data dalam DATA. QUERY_INFORMATION. Anggota InformationBuffer tidak dimodifikasi oleh driver miniport.

Keterangan

Mengembalikan Kode Status

Driver miniport adaptor jaringan VM mengembalikan salah satu kode status berikut untuk permintaan OID ini:

Kode Status	Deskripsi
NDIS_STATUS_SUCCESS	Permintaan OID berhasil diselesaikan.
NDIS_STATUS_INVALID_LENGTH	Panjang buffer informasi terlalu kecil untuk mengembalikan informasi yang diminta. Driver miniport adaptor jaringan VM mengatur DATA. METHOD_INFORMATION. Anggota BytesNeeded dalam struktur NDIS_OID_REQUEST ke ukuran buffer minimum, dalam byte, yang diperlukan.
NDIS_STATUS_FAILURE	Permintaan gagal karena alasan lain.