struktur WSK_PROVIDER_DISPATCH (wsk.h)

Artikel
03/01/2024

Struktur WSK_PROVIDER_DISPATCH menentukan tabel fungsi pengiriman subsistem WSK yang tidak spesifik untuk soket tertentu.

Sintaks

typedef struct _WSK_PROVIDER_DISPATCH {
  USHORT                    Version;
  USHORT                    Reserved;
  PFN_WSK_SOCKET            WskSocket;
  PFN_WSK_SOCKET_CONNECT    WskSocketConnect;
  PFN_WSK_CONTROL_CLIENT    WskControlClient;
  PFN_WSK_GET_ADDRESS_INFO  WskGetAddressInfo;
  PFN_WSK_FREE_ADDRESS_INFO WskFreeAddressInfo;
  PFN_WSK_GET_NAME_INFO     WskGetNameInfo;
} WSK_PROVIDER_DISPATCH, *PWSK_PROVIDER_DISPATCH;

Anggota

Version

Versi WSK Network Programming Interface (NPI) yang akan digunakan subsistem WSK untuk lampirannya ke aplikasi WSK.

Reserved

Dicadangkan untuk penggunaan sistem.

WskSocket

Penunjuk ke fungsi WskSocket subsistem WSK .

WskSocketConnect

Penunjuk ke fungsi WskSocketConnect subsistem WSK .

WskControlClient

Penunjuk ke fungsi WskControlClient subsistem WSK .

WskGetAddressInfo

Penunjuk ke fungsi WskGetAddressInfo subsistem WSK.

Anggota ini tersedia dimulai dengan Windows 7.

WskFreeAddressInfo

Penunjuk ke fungsi WskFreeAddressInfo subsistem WSK.

Anggota ini tersedia dimulai dengan Windows 7.

WskGetNameInfo

Penunjuk ke fungsi WskGetNameInfo subsistem WSK.

Anggota ini tersedia dimulai dengan Windows 7.

Keterangan

Ketika aplikasi WSK memanggil fungsi WskCaptureProviderNPI , subsistem WSK mengembalikan penunjuk ke struktur WSK_PROVIDER_DISPATCH dengan menggunakan anggota Pengiriman dari struktur WSK_CLIENT_NPI yang diarahkan oleh parameter WskProviderNpi .

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

Version = MAKE_WSK_VERSION(Major,Minor);

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

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

Nomor versi minor yang terkandung dalam anggota Versi struktur ini mungkin merupakan nomor versi minor yang lebih tinggi daripada yang diminta oleh aplikasi WSK di anggota Versi struktur WSK_CLIENT_DISPATCH . Situasi ini seharusnya tidak menyebabkan masalah untuk aplikasi WSK karena versi minor yang lebih tinggi dari WSK NPI adalah superset ketat dari versi minor yang lebih rendah dari WSK NPI jika mereka memiliki nomor versi utama yang sama. Subsistem WSK akan menentukan anggota struktur WSK_PROVIDER_DISPATCH yang tersisa agar sesuai dengan versi WSK NPI yang ditunjukkan dalam anggota Versi struktur.

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