Bagikan melalui


OID_QOS_PARAMETERS

Komponen Data Center Bridging (DCB) (Msdcb.sys) mengeluarkan permintaan metode pengidentifikasi objek (OID) OID_QOS_PARAMETERS untuk mengonfigurasi parameter Kualitas Layanan (QoS) NDIS lokal pada adaptor jaringan.

Anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke struktur NDIS_QOS_PARAMETERS .

Catatan Permintaan metode OID ini wajib untuk driver miniport yang mendukung NDIS QoS untuk antarmuka IEEE 802.1 Data Center Bridging (DCB).

Keterangan

Driver Miniport mendapatkan parameter QoS NDIS lokal melalui permintaan metode OID OID_QOS_PARAMETERS. Parameter ini menentukan bagaimana adaptor jaringan memprioritaskan pengiriman, atau keluar, paket. Untuk informasi selengkapnya tentang parameter ini, lihat Gambaran Umum Parameter QoS NDIS.

Catatan Hanya komponen DCB yang dapat mengeluarkan permintaan metode OID OID_QOS_PARAMETERS. Protokol yang terlalu berlebihan atau driver filter tidak boleh mengeluarkan OID ini. Untuk informasi selengkapnya tentang komponen DCB, lihat Arsitektur QoS NDIS untuk Bridging Pusat Data.

Komponen DCB mengeluarkan permintaan OID_QOS_PARAMETERS dalam kondisi berikut:

  • Administrator sistem menginstal atau menghapus instalan fitur server Microsoft DCB.

    Untuk informasi selengkapnya tentang fitur server DCB, lihat Komponen DCB yang Disediakan Sistem.

  • Administrator sistem mengaktifkan atau menonaktifkan fitur server DCB saat fitur masih diinstal.

  • Administrator sistem mengubah salah satu parameter fitur server DCB.

  • Sistem operasi dimulai atau dimulai ulang saat fitur server DCB diinstal.

Ketika driver miniport menangani permintaan metode OID OID_QOS_PARAMETERS, driver miniport harus mengikuti panduan berikut:

  • Driver miniport menyalin data dalam struktur NDIS_QOS_PARAMETERS ke cache parameter QoS NDIS lokalnya. Driver kemudian menyelesaikan parameter QoS NDIS operasionalnya berdasarkan cache parameter QoS NDIS lokal dan cache parameter QoS NDIS yang diterimanya dari peer jarak jauh.

    Untuk informasi selengkapnya tentang cara driver miniport menyelesaikan parameter operasionalnya, lihat Menyelesaikan Parameter QoS NDIS Operasional.

  • Driver miniport tidak boleh memodifikasi data apa pun yang terkandung dalam struktur NDIS_QOS_PARAMETERS . Driver harus menyelesaikan permintaan metode OID dan mengembalikan data asli dalam struktur NDIS_QOS_PARAMETERS .

  • Bendera NDIS_QOS_PARAMETERS_WILLING menentukan apakah driver miniport mengaktifkan atau menonaktifkan status Willing Data Center Bridging Exchange (DCBX) lokal. Driver menangani bendera ini dengan cara berikut:

    • Jika bendera ini diatur, driver miniport harus mengaktifkan status DCBX Willing lokal. Ini memungkinkan driver untuk dikonfigurasi dari jarak jauh dengan pengaturan QoS. Dalam hal ini, driver menyelesaikan parameter QoS operasionalnya berdasarkan parameter QoS jarak jauh. Driver miniport juga dapat menyelesaikan parameter QoS operasionalnya berdasarkan pengaturan QoS kepemilikan apa pun yang ditentukan oleh vendor perangkat keras independen (IHV).

    • Jika bendera ini tidak diatur, driver miniport harus menonaktifkan status DCBX Willing lokal. Ini memungkinkan driver untuk menyelesaikan parameter QoS operasionalnya dari parameter QoS lokalnya alih-alih parameter QoS jarak jauh. Driver miniport juga harus menonaktifkan atau mengambil alih parameter QoS lokal yang bendera NDIS_QOS_PARAMETERS_Xxx_CONFIGURED terkait tidak diatur.

      Misalnya, driver miniport dapat mengambil alih parameter QoS lokal yang tidak dikonfigurasi dengan pengaturan kepemilikannya untuk parameter QoS yang ditentukan oleh IHV. Jika tidak ada pengaturan kepemilikan untuk parameter QoS lokal yang tidak ditentukan dengan bendera NDIS_QOS_PARAMETERS_Xxx_CONFIGURED , driver harus menonaktifkan penggunaan parameter QoS ini pada adaptor jaringan.

      Catatan Driver juga dapat mengambil alih parameter QoS lokal yang dikonfigurasi jika mereka membahayakan parameter QoS yang digunakan oleh protokol atau teknologi yang diaktifkan pada adaptor jaringan. Misalnya, driver dapat mengambil alih parameter QoS lokal jika adaptor jaringan diaktifkan untuk boot jarak jauh melalui protokol Fibre Channel over Ethernet (FCoE).

    Untuk informasi selengkapnya tentang status DCBX Willing lokal, lihat Mengelola Status DCBX Lokal yang Bersedia.

Untuk informasi selengkapnya tentang bagaimana driver miniport mengambil alih parameter QoS lokal, lihat Mengelola Parameter QoS NDIS.

Catatan Mengesampingkan parameter QoS lokal seharusnya tidak menyebabkan driver miniport gagal dalam permintaan metode OID OID_QOS_PARAMETERS.

Untuk informasi selengkapnya tentang cara driver miniport mengelola parameter QoS lokal, lihat Mengatur Parameter QoS NDIS Lokal.

Mengembalikan Kode Status

Driver miniport mengembalikan salah satu kode status berikut.

Kode Status Deskripsi

NDIS_STATUS_SUCCESS

Permintaan OID berhasil diselesaikan.

NDIS_STATUS_PENDING

Permintaan OID tertunda penyelesaiannya. Ketika driver miniport memanggil NdisMOidRequestComplete, NDIS akan meneruskan kode status akhir dan hasil ke handler penyelesaian permintaan OID dari pemanggil setelah permintaan selesai.

NDIS_STATUS_NOT_SUPPORTED

Driver miniport tidak mendukung antarmuka QoS NDIS.

NDIS_STATUS_INVALID_PARAMETER

Satu atau beberapa anggota struktur NDIS_QOS_PARAMETERS berisi nilai yang salah.

NDIS_STATUS_INVALID_LENGTH

Panjang buffer informasi kurang dari sizeof(NDIS_QOS_PARAMETERS). NDIS 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.

Persyaratan

Versi

Didukung di NDIS 6.30 dan yang lebih baru.

Header

Ntddndis.h (termasuk Ndis.h)

Lihat juga


NdisMOidRequestComplete

NDIS_OID_REQUEST

NDIS_QOS_CAPABILITIES

NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE

NDIS_STATUS_QOS_REMOTE_PARAMETERS_CHANGE