struktur WSK_PROVIDER_CHARACTERISTICS (wsk.h)

Artikel
03/01/2024

Struktur WSK_PROVIDER_CHARACTERISTICS menentukan karakteristik subsistem WSK.

Sintaks

typedef struct _WSK_PROVIDER_CHARACTERISTICS {
  USHORT HighestVersion;
  USHORT LowestVersion;
} WSK_PROVIDER_CHARACTERISTICS, *PWSK_PROVIDER_CHARACTERISTICS;

Anggota

HighestVersion

Versi tertinggi WSK Network Programming Interface (NPI) yang didukung oleh subsistem WSK.

LowestVersion

Versi terendah dari WSK NPI yang didukung oleh subsistem WSK.

Keterangan

Ketika panggilan WskCaptureProviderNPI gagal dengan kode status STATUS_NOINTERFACE, aplikasi WSK dapat menggunakan panggilan ke WskQueryProviderCharacteristics untuk mengkueri rentang versi WSK NPI yang didukung oleh subsistem WSK. WskQueryProviderCharacteristics mengembalikan informasi versi dengan struktur WSK_PROVIDER_CHARACTERISTICS. Aplikasi WSK dapat menggunakan informasi ini untuk menentukan apakah subsistem WSK mendukung versi WSK NPI yang kompatibel dengan aplikasi.

Nomor versi utama dan minor yang terkandung dalam anggota HighestVersion dan LowestVersion dikodekan dengan menggunakan makro MAKE_WSK_VERSION:

Version = MAKE_WSK_VERSION(Major,Minor);

Nomor versi utama dan minor dapat diekstrak dari anggota HighestVersion dan LowestVersion dengan menggunakan makro WSK_MAJOR_VERSION dan WSK_MINOR_VERSION:

Major = WSK_MAJOR_VERSION(Version);
Minor = WSK_MINOR_VERSION(Version);

Jika aplikasi WSK menentukan bahwa subsistem WSK mendukung versi WSK NPI yang kompatibel dengan aplikasi, aplikasi harus memanggil WskRegister dan, dengan cara anggota Pengiriman struktur WSK_CLIENT_NPI yang diacu oleh parameter WskClientNpi , aplikasi harus menentukan versi yang tepat dari WSK NPI yang ingin digunakan dalam anggota Versi struktur WSK_CLIENT_DISPATCH . Aplikasi WSK harus menentukan anggota struktur WSK_CLIENT_DISPATCH yang tersisa agar sesuai dengan versi WSK NPI yang ditentukan dalam anggota Versi struktur.

Untuk informasi selengkapnya tentang melampirkan aplikasi WSK ke subsistem WSK, lihat Mendaftarkan Aplikasi Kernel Winsock.