OID_NIC_SWITCH_CURRENT_CAPABILITIES

  • Artikel

Driver yang terlalu berlebihan mengeluarkan permintaan kueri pengidentifikasi objek (OID) OID_NIC_SWITCH_CURRENT_CAPABILITIES untuk mendapatkan kemampuan perangkat keras yang saat ini diaktifkan dari sakelar NIC dalam adaptor jaringan.

Setelah berhasil mengembalikan dari permintaan kueri OID, anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke struktur NDIS_NIC_SWITCH_CAPABILITIES .

Keterangan

Dimulai dengan NDIS 6.20, driver miniport menyediakan kemampuan perangkat keras sakelar NIC yang saat ini diaktifkan pada adaptor jaringan ketika fungsi MiniportInitializeEx-nya dipanggil. Driver menginisialisasi struktur NDIS_NIC_SWITCH_CAPABILITIES dengan kemampuan perangkat keras sakelar NIC dan mengatur anggota CurrentNicSwitchCapabilities dari struktur NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES ke penunjuk ke struktur NDIS_NIC_SWITCH_CAPABILITIES . Driver miniport kemudian memanggil fungsi NdisMSetMiniportAttributes dan mengatur parameter MiniportAttributes ke penunjuk ke struktur NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES .

Catatan Dimulai dengan NDIS 6.30, driver miniport yang mendukung antarmuka virtualisasi I/O root tunggal (SR-IOV) harus mendaftarkan kemampuan perangkat keras yang diaktifkan dari sakelar NIC. Driver mendaftarkan kemampuan ini dengan memanggil NdisMSetMiniportAttributes.

Protokol yang terlalu berlebihan dan driver filter tidak perlu mengeluarkan permintaan kueri OID OID_NIC_SWITCH_CURRENT_CAPABILITIES. NDIS menyediakan kemampuan perangkat keras sakelar NIC yang saat ini diaktifkan dari adaptor jaringan ke driver ini dengan cara berikut:

  • NDIS melaporkan kemampuan perangkat keras sakelar NIC yang saat ini diaktifkan dari adaptor jaringan yang mendasarinya ke driver protokol yang terlalu mengikat di anggota NicSwitchCapabilities dari struktur NDIS_BIND_PARAMETERS selama operasi pengikatan.

  • NDIS melaporkan kemampuan perangkat keras sakelar NIC yang saat ini diaktifkan dari adaptor jaringan yang mendasarinya ke driver filter yang terlalu berlebihan di anggota NicSwitchCapabilities dari struktur NDIS_FILTER_ATTACH_PARAMETERS selama operasi pemasangan.

Mengembalikan Kode Status

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

Saat NDIS menangani permintaan OID_NIC_SWITCH_CURRENT_CAPABILITIES, NDIS mengembalikan salah satu kode status berikut:

Kode Status Deskripsi

NDIS_STATUS_SUCCESS

Permintaan berhasil diselesaikan. InformationBuffer menunjuk ke struktur NDIS_NIC_SWITCH_CAPABILITIES.

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

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

Persyaratan

Versi

Didukung di NDIS 6.20 dan yang lebih baru.

Header

 Ntddndis.h (termasuk Ndis.h)

Lihat juga

NDIS_BIND_PARAMETERS

NDIS_FILTER_ATTACH_PARAMETERS

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES

NDIS_NIC_SWITCH_CAPABILITIES

NDIS_OID_REQUEST