struktur NDIS_PORT_CHARACTERISTICS (ntddndis.h)

Artikel
08/07/2023

Struktur NDIS_PORT_CHARACTERISTICS menentukan karakteristik port NDIS. Untuk informasi selengkapnya tentang port NDIS, lihat Port NDIS.

Sintaks

typedef struct _NDIS_PORT_CHARACTERISTICS {
  NDIS_OBJECT_HEADER            Header;
  NDIS_PORT_NUMBER              PortNumber;
  ULONG                         Flags;
  NDIS_PORT_TYPE                Type;
  NDIS_MEDIA_CONNECT_STATE      MediaConnectState;
  ULONG64                       XmitLinkSpeed;
  ULONG64                       RcvLinkSpeed;
  NET_IF_DIRECTION_TYPE         Direction;
  NDIS_PORT_CONTROL_STATE       SendControlState;
  NDIS_PORT_CONTROL_STATE       RcvControlState;
  NDIS_PORT_AUTHORIZATION_STATE SendAuthorizationState;
  NDIS_PORT_AUTHORIZATION_STATE RcvAuthorizationState;
} NDIS_PORT_CHARACTERISTICS, *PNDIS_PORT_CHARACTERISTICS;

Anggota

Header

Struktur NDIS_OBJECT_HEADER untuk struktur NDIS_PORT_CHARACTERISTICS . Atur anggota Jenis struktur yang ditentukan Header ke NDIS_OBJECT_TYPE_DEFAULT, anggota Revisi ke NDIS_PORT_CHARACTERISTICS_REVISION_1, dan anggota Ukuran ke NDIS_SIZEOF_PORT_CHARACTERISTICS_REVISION_1.

PortNumber

Jumlah port NDIS yang terkait dengan struktur NDIS_PORT_CHARACTERISTICS ini. Nilai PortNumber adalah nilai NDIS_PORT_NUMBER, yang memiliki jenis data ULONG dan berlaku dari nol hingga 0xffffff, di mana nol dicadangkan untuk port default.

Flags

Kombinasi bitwise OR dari bendera karakteristik port, atau nol jika tidak ada bendera yang diatur. Saat ini ada satu bendera.

Jika bendera NDIS_PORT_CHAR_USE_DEFAULT_AUTH_SETTINGS diatur, NDIS mengabaikan pengaturan status autentikasi dan menggunakan status autentikasi default sebagai gantinya. Driver miniport dapat menggunakan bendera ini untuk meminta agar NDIS menggunakan pengaturan status autentikasi default untuk port yang dialokasikan dan diaktifkan. Jika driver miniport mengontrol port default, ketika driver miniport mengaktifkan port default, driver dapat mengatur NDIS_PORT_CHAR_USE_DEFAULT_AUTH_SETTINGS untuk mengaktifkan port default dengan pengaturan status autentikasi default.

Type

Jenis port NDIS. Untuk informasi selengkapnya, lihat Jenis Port NDIS. Jenis ini bisa menjadi salah satu nilai berikut:

NdisPortTypeUndefined

Jenis port default.

NdisPortTypeBridge

Dicadangkan untuk penggunaan sistem.

NdisPortTypeRasConnection

Koneksi Layanan Akses Jarak Jauh (RAS).

NdisPortType8021xSupplicant

Stasiun nirkabel jarak jauh yang terkait dengan titik akses pada komputer host ini.

NdisPortTypeNdisImPlatform

Dicadangkan untuk penggunaan sistem.

Catatan Nilai ini hanya didukung di NDIS 6.30 dan yang lebih baru.

MediaConnectState

Status koneksi media port. Status ini adalah informasi yang sama dengan OID_GEN_MEDIA_CONNECT_STATUS_EX OID kembali.

XmitLinkSpeed

Kecepatan tautan transmisi port dalam bit per detik. Nilai -1 dalam anggota ini menunjukkan bahwa kecepatan tautan pengiriman tidak diketahui.

RcvLinkSpeed

Kecepatan tautan terima port, dalam bit per detik. Nilai -1 dalam anggota ini menunjukkan bahwa kecepatan tautan terima tidak diketahui.

Direction

Jenis arah antarmuka jaringan NET_IF_DIRECTION_TYPE NDIS.

SendControlState

Status kontrol port untuk operasi pengiriman. Anggota ini harus berisi salah satu nilai berikut:

NdisPortControlStateUnknown

Status kontrol port untuk operasi pengiriman tidak diketahui.

NdisPortControlStateControlled

Port dalam keadaan terkontrol untuk operasi pengiriman. Artinya, port membutuhkan otorisasi.

NdisPortControlStateUncontrolled

Port dalam keadaan tidak terkontrol untuk operasi pengiriman. Artinya, port tidak memerlukan otorisasi.

RcvControlState

Status kontrol port untuk menerima operasi. Anggota ini harus berisi salah satu nilai berikut:

NdisPortControlStateUnknown

Status kontrol port untuk operasi penerimaan tidak diketahui.

NdisPortControlStateControlled

Port berada dalam status terkontrol untuk menerima operasi (yaitu, port memerlukan otorisasi), dan nilai dalam anggota SendAuthorizationState menentukan status autentikasi.

NdisPortControlStateUncontrolled

Port dalam keadaan tidak terkontrol untuk menerima operasi. Oleh karena itu, autentikasi tidak berlaku untuk port ini.

SendAuthorizationState

Status otorisasi port untuk operasi pengiriman. Abaikan anggota ini jika anggota SendControlState diatur ke NdisPortControlStateUncontrolled.

SendAuthorizationState harus berisi salah satu nilai berikut:

NdisPortAuthorizationUnknown

Status otorisasi port untuk operasi pengiriman tidak diketahui.

NdisPortAuthorized

Port diotorisasi untuk operasi pengiriman.

NdisPortUnauthorized

Port tidak diotorisasi untuk operasi pengiriman.

NdisPortReauthorizing

Port mengotorisasi ulang untuk operasi pengiriman.

RcvAuthorizationState

Status otorisasi port untuk menerima operasi. Abaikan anggota ini jika anggota RcvControlState diatur ke NdisPortControlStateUncontrolled.

RcvAuthorizationState harus berisi salah satu nilai berikut:

NdisPortAuthorizationUnknown

Status otorisasi port untuk operasi penerimaan tidak diketahui.

NdisPortAuthorized

Port diotorisasi untuk menerima operasi.

NdisPortUnauthorized

Port tidak diotorisasi untuk menerima operasi.

NdisPortReauthorizing

Port mengotorisasi ulang untuk menerima operasi.

Keterangan

Struktur NDIS_PORT_CHARACTERISTICS menentukan karakteristik port NDIS. Struktur ini muncul dalam daftar karakteristik port yang disediakan dalam struktur NDIS_PORT_ARRAY yang digunakan dengan OID_GEN_ENUMERATE_PORTS OID.

Untuk mengalokasikan port NDIS, driver menginisialisasi struktur NDIS_PORT_CHARACTERISTICS dan meneruskannya ke fungsi NdisMAllocatePort . Ketika NdisMAllocatePort berhasil mengembalikan, NDIS menetapkan anggota PortNumberdari NDIS_PORT_CHARACTERISTICS ke nomor port yang ditetapkan NDIS ke port.

NDIS menggunakan daftar port yang ditautkan dalam peristiwa Plug and Play aktivasi port (PnP). NDIS menggunakan struktur NDIS_PORT untuk membuat daftar port yang ditautkan, dan setiap struktur NDIS_PORT berisi struktur NDIS_PORT_CHARACTERISTICS .