struktur NDIS_SWITCH_PORT_PROPERTY_PROFILE (ntddndis.h)

Artikel
08/07/2023

Struktur NDIS_SWITCH_PORT_PROPERTY_PROFILE menentukan properti kebijakan untuk port sakelar yang dapat diperluas Hyper-V yang disimpan ekstensi sakelar yang dapat diperluas di penyimpanan kebijakannya sendiri alih-alih di penyimpanan kebijakan Hyper-V. Dalam hal ini, definisi kebijakan diidentifikasi oleh profil properti dalam penyimpanan kebijakan driver.

Sintaks

typedef struct _NDIS_SWITCH_PORT_PROPERTY_PROFILE {
  NDIS_OBJECT_HEADER                          Header;
  ULONG                                       Flags;
  NDIS_SWITCH_PORT_PROPERTY_PROFILE_NAME      ProfileName;
  GUID                                        ProfileId;
  NDIS_VENDOR_NAME                            VendorName;
  GUID                                        VendorId;
  UINT32                                      ProfileData;
  GUID                                        NetCfgInstanceId;
  struct {
    UINT32 PciSegmentNumber : 16;
    UINT32 PciBusNumber : 8;
    UINT32 PciDeviceNumber : 5;
    UINT32 PciFunctionNumber : 3;
  } PciLocation;
  UINT32                                      CdnLabelId;
  NDIS_SWITCH_PORT_PROPERTY_PROFILE_CDN_LABEL CdnLabel;
} NDIS_SWITCH_PORT_PROPERTY_PROFILE, *PNDIS_SWITCH_PORT_PROPERTY_PROFILE;

Anggota

Header

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

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

NDIS_SWITCH_PORT_PROPERTY_PROFILE_REVISION_1

Versi asli untuk NDIS 6.30 dan yang lebih baru.

Atur anggota Ukuran ke NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_PROFILE_REVISION_1.

Flags

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

ProfileName

Nilai NDIS_SWITCH_PORT_PROPERTY_PROFILE_NAME yang menentukan nama properti profil yang mudah digunakan.

ProfileId

Nilai GUID yang secara unik mengidentifikasi properti profil.

VendorName

Nilai NDIS_VENDOR_NAME yang menentukan nama vendor yang mudah digunakan yang menentukan profil port.

VendorId

Nilai GUID yang mengidentifikasi vendor yang menentukan profil port.

ProfileData

NetCfgInstanceId

Nilai GUID yang menentukan nilai registri NetCfgInstanceId dari koneksi adaptor jaringan yang mendasar tempat properti diterapkan.

Nilai NetCfgInstanceId ditentukan untuk koneksi adaptor jaringan melalui permintaan set pengidentifikasi objek (OID) OID_SWITCH_NIC_CREATE.

PciLocation

Struktur yang menentukan lokasi PCI adaptor jaringan fisik yang mendasar yang ditentukan oleh anggota NetCfgInstanceId .

Untuk informasi lebih lanjut, lihat bagian Keterangan.

PciLocation.PciSegmentNumber

Nilai yang menentukan grup bus PCI tempat adaptor jaringan fisik terpasang.

PciLocation.PciBusNumber

Nilai yang menentukan nomor bus PCI saat ini tempat adaptor jaringan fisik terpasang.

PciLocation.PciDeviceNumber

Nilai yang menentukan nomor perangkat untuk adaptor jaringan fisik pada bus PCI.

Catatan Nomor perangkat PCI juga dikenal sebagai nomor slot PCI.

PciLocation.PciFunctionNumber

Nilai yang menentukan jumlah fungsi perangkat logis pada adaptor jaringan fisik.

CdnLabelId

Nilai UINT32 yang menentukan pengidentifikasi unik untuk data yang terkandung dalam anggota CdnLabel .

CdnLabel

Nilai NDIS_SWITCH_PORT_PROPERTY_PROFILE_CDN_LABEL yang menentukan label CDN PCI Express (PCIe) untuk lokasi adaptor jaringan fisik. Label CDN menyediakan lokasi perangkat yang konsisten di seluruh lokasi perangkat keras serupa.

Keterangan

Struktur NDIS_SWITCH_PORT_PROPERTY_PROFILE digunakan oleh ekstensi untuk mereferensikan properti kebijakan dalam penyimpanan kebijakan privat alih-alih penyimpanan kebijakan Hyper-V. Ini memungkinkan vendor perangkat lunak independen (ISV) untuk mengisi dan mengelola penyimpanan kebijakan privat ini melalui saluran dan antarmuka privat. Vendor dapat membedakan profil mereka dari profil vendor lain menggunakan bidang VendorName dan VendorId .

Catatan Properti kebijakan port yang ditentukan oleh struktur NDIS_SWITCH_PORT_PROPERTY_PROFILE transparan terhadap antarmuka sakelar yang dapat diperluas.

Struktur NDIS_SWITCH_PORT_PROPERTY_PROFILE digunakan dalam permintaan set OID berikut:

Struktur NDIS_SWITCH_PORT_PROPERTY_PROFILE mengikuti struktur NDIS_SWITCH_PORT_PROPERTY_PARAMETERS dalam buffer yang terkait dengan permintaan set OID ini. Anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke buffer ini.

Catatan Jenis data NDIS_SWITCH_PORT_PROPERTY_PROFILE_NAME dan NDIS_SWITCH_PORT_PROPERTY_PROFILE_CDN_LABEL ditentukan oleh struktur IF_COUNTED_STRING . String yang ditentukan oleh struktur ini tidak harus dihentikan null. Namun, panjang string harus diatur dalam anggota Panjang struktur ini. Jika string dihentikan null, anggota Panjang tidak boleh menyertakan karakter null yang mengakhiri.

Anggota PciLocation dan CdnLabel hanya relevan jika profil properti menentukan kebijakan untuk adaptor jaringan fisik dasar yang dilampirkan ke adaptor jaringan eksternal sakelar yang dapat diperluas. Misalnya, jika adaptor jaringan eksternal terikat ke tim adaptor sakelar yang dapat diperluas, anggota ini dapat menentukan kebijakan untuk satu adaptor dari tim tersebut. Untuk informasi selengkapnya tentang tim pengalih yang dapat diperluas, lihat Jenis Konfigurasi Adaptor Jaringan Fisik.