struktur NPI_REGISTRATION_INSTANCE (netioddk.h)

Struktur NPI_REGISTRATION_INSTANCE mendefinisikan data yang terkait dengan pendaftaran modul jaringan dengan NMR.

Sintaks

typedef struct _NPI_REGISTRATION_INSTANCE {
  USHORT        Version;
  USHORT        Size;
  PNPIID        NpiId;
  PNPI_MODULEID ModuleId;
  ULONG         Number;
  const VOID    *NpiSpecificCharacteristics;
} NPI_REGISTRATION_INSTANCE;

Anggota

Version

Versi NMR tempat modul jaringan mendaftar. Modul jaringan harus mengatur anggota ini ke nol.

Size

Ukuran, dalam byte, dari struktur NPI_REGISTRATION_INSTANCE.

NpiId

Penunjuk ke pengidentifikasi NPI untuk NPI tertentu tempat modul jaringan mendaftar sebagai klien atau penyedia. Jenis data NPIID didefinisikan sebagai:

typedef GUID NPIID;
typedef CONST NPIID *PNPIID;

ModuleId

Penunjuk ke struktur NPI_MODULEID yang secara unik mengidentifikasi modul jaringan.

Number

Nomor implementasi NPI tempat modul jaringan terdaftar sebagai klien atau penyedia. Modul jaringan dapat mendukung beberapa implementasi NPI yang sama dengan mendaftar sebagai klien atau penyedia setiap implementasi NPI. Jika hanya ada satu implementasi NPI, anggota ini diatur ke nol.

NpiSpecificCharacteristics

Penunjuk ke struktur yang menentukan karakteristik yang unik untuk modul jaringan. Isi strukturnya khusus untuk NPI. Modul jaringan harus mengatur anggota ini ke NULL jika mendaftar sebagai klien NPI yang tidak menentukan struktur karakteristik klien atau jika mendaftar sebagai penyedia NPI yang tidak menentukan struktur karakteristik penyedia.

Keterangan

Struktur NPI_REGISTRATION_INSTANCE adalah anggota NPI_CLIENT_CHARACTERISTICS dan NPI_PROVIDER_CHARACTERISTICS struktur. Struktur ini digunakan untuk mendaftarkan modul jaringan dengan NMR.

Ketika NMR memanggil fungsi panggilan balik ClientAttachProvider modul klien, NMR meneruskan pointer ke struktur NPI_REGISTRATION_INSTANCE untuk modul penyedia tempat modul klien dapat melampirkan dirinya sendiri. Demikian juga, ketika NMR memanggil fungsi panggilan balik ProviderAttachClient modul penyedia, ia meneruskan pointer ke struktur NPI_REGISTRATION_INSTANCE untuk modul klien tempat modul penyedia dapat melampirkan dirinya sendiri.

Modul jaringan harus memastikan bahwa memori untuk NPIID yang ditunjukkan oleh anggota NpiId , memori untuk struktur NPI_MODULEID yang ditunjukkan oleh anggota ModuleId , dan memori untuk struktur karakteristik khusus NPI yang ditunjukkan oleh anggota NpiSpecificCharacteristics tetap valid dan tinggal dalam memori selama modul jaringan terdaftar dengan NMR.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows Vista dan versi yang lebih baru dari sistem operasi Windows.
Header	netioddk.h (termasuk Wsk.h)

Lihat juga

ClientAttachProvider

NPI_CLIENT_CHARACTERISTICS

NPI_MODULEID

NPI_PROVIDER_CHARACTERISTICS

ProviderAttachClient