struktur NDIS_SWITCH_NIC_OID_REQUEST (ntddndis.h)

Artikel
02/26/2024

Struktur NDIS_SWITCH_NIC_OID_REQUEST menentukan informasi yang diperlukan untuk meneruskan atau berasal dari permintaan OID.

Sintaks

typedef struct _NDIS_SWITCH_NIC_OID_REQUEST {
  NDIS_OBJECT_HEADER    Header;
  ULONG                 Flags;
  NDIS_SWITCH_PORT_ID   SourcePortId;
  NDIS_SWITCH_NIC_INDEX SourceNicIndex;
  NDIS_SWITCH_PORT_ID   DestinationPortId;
  NDIS_SWITCH_NIC_INDEX DestinationNicIndex;
  PNDIS_OID_REQUEST     OidRequest;
} NDIS_SWITCH_NIC_OID_REQUEST, *PNDIS_SWITCH_NIC_OID_REQUEST;

Anggota

Header

Jenis, revisi, dan ukuran struktur NDIS_SWITCH_NIC_OID_REQUEST . Anggota ini diformat sebagai struktur NDIS_OBJECT_HEADER .

Anggota JenisHeader harus diatur ke NDIS_OBJECT_TYPE_DEFAULT. Untuk menentukan versi struktur NDIS_SWITCH_NIC_OID_REQUEST , anggota RevisiHeader harus diatur ke nilai berikut:

NDIS_SWITCH_NIC_OID_REQUEST_REVISION_1

Versi asli untuk NDIS 6.30 dan yang lebih baru.

Atur anggota Ukuran ke NDIS_SIZEOF_NDIS_SWITCH_NIC_OID_REQUEST_REVISION_1.

Flags

Nilai ULONG yang berisi bitwise OR dari bendera. Anggota ini dicadangkan untuk NDIS.

SourcePortId

Nilai NDIS_SWITCH_PORT_ID yang berisi pengidentifikasi unik port sakelar yang dapat diperluas Hyper-V tempat permintaan OID awalnya dikeluarkan.

SourceNicIndex

Nilai NDIS_SWITCH_NIC_INDEX yang menentukan indeks adaptor jaringan sumber yang tersambung ke port sakelar sumber yang dapat diperluas yang ditentukan oleh anggota SourcePortId .

DestinationPortId

Nilai NDIS_SWITCH_PORT_ID yang berisi pengidentifikasi unik port sakelar yang dapat diperluas tempat permintaan OID akan diteruskan.

DestinationNicIndex

Nilai NDIS_SWITCH_NIC_INDEX yang menentukan indeks adaptor jaringan tujuan yang tersambung ke port sakelar yang dapat diperluas yang ditentukan oleh anggota DestinationPortId .

OidRequest

Penunjuk ke struktur NDIS_OID_REQUEST . Struktur ini berisi data untuk permintaan OID yang akan diteruskan ke driver miniport adaptor jaringan yang ditentukan oleh anggota DestinationPortId dan DestinationNicIndex .

Keterangan

Struktur NDIS_SWITCH_NIC_OID_REQUEST digunakan dalam permintaan metode OID OID_SWITCH_NIC_REQUEST.

Ekstensi dapat meneruskan atau berasal dari permintaan OID ke adaptor jaringan fisik yang mendasar di tumpukan driver sakelar yang dapat diperluas. Ini memungkinkan ekstensi untuk melakukan hal berikut:

Kelola konfigurasi offload perangkat keras pada adaptor fisik yang mendasar untuk teknologi offload berikut:
- Keamanan Protokol Internet (IPsec).
- Antrean komputer virtual (VMQ).
- Virtualisasi I/O root tunggal (SR-IOV).
Mengkueri konfigurasi adaptor jaringan fisik yang mendasar dengan mengeluarkan OID NDIS standar. Misalnya, ekstensi dapat mengeluarkan permintaan kueri OID OID_802_3_CURRENT_ADDRESS untuk mendapatkan alamat kontrol akses media (MAC) adaptor saat ini.

Untuk panduan tentang cara mengeluarkan permintaan OID ke adaptor fisik yang mendasar, lihat Mengelola Permintaan OID ke Adaptor Jaringan Fisik.