структура NPI_REGISTRATION_INSTANCE (netioddk.h)

Структура NPI_REGISTRATION_INSTANCE определяет данные, связанные с регистрацией сетевого модуля в NMR.

Синтаксис

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

Участники

Version

Версия NMR, с которой регистрируется сетевой модуль. Сетевой модуль должен присвоить этому члену нулевое значение.

Size

Размер структуры NPI_REGISTRATION_INSTANCE в байтах.

NpiId

Указатель на идентификатор NPI для конкретного NPI , в котором сетевой модуль регистрируется как клиент или поставщик. Тип данных NPIID определяется следующим образом:

typedef GUID NPIID;
typedef CONST NPIID *PNPIID;

ModuleId

Указатель на структуру NPI_MODULEID , которая однозначно идентифицирует сетевой модуль.

Number

Номер реализации NPI , для которого сетевой модуль регистрируется как клиент или поставщик. Сетевой модуль может поддерживать несколько реализаций одного ИП, регистрируясь как клиент или поставщик каждой реализации NPI. Если существует только одна реализация NPI, этот элемент имеет значение 0.

NpiSpecificCharacteristics

Указатель на структуру, указывающую характеристики, уникальные для сетевого модуля. Содержимое структуры зависит от NPI. Сетевой модуль должен присвоить этому члену значение NULL , если он регистрируется как клиент NPI, который не определяет структуру характеристик клиента или регистрируется как поставщик NPI, который не определяет структуру характеристик поставщика.

Комментарии

Структура NPI_REGISTRATION_INSTANCE является членом NPI_CLIENT_CHARACTERISTICS и NPI_PROVIDER_CHARACTERISTICS структуры. Эти структуры используются для регистрации сетевых модулей в NMR.

Когда NMR вызывает функцию обратного вызова ClientAttachProvider модуля cleint, он передает указатель на структуру NPI_REGISTRATION_INSTANCE для модуля поставщика, к которому может подключиться клиентский модуль. Аналогичным образом, когда NMR вызывает функцию обратного вызова ProviderAttachClient модуля поставщика, он передает указатель на структуру NPI_REGISTRATION_INSTANCE для клиентского модуля, к которому модуль поставщика может подключиться.

Сетевой модуль должен убедиться, что память для NPIID, на которую указывает член NpiId , память для структуры NPI_MODULEID , на которую указывает элемент ModuleId , и память для структуры характеристик NPI, на которую указывает член NpiSpecificCharacteristics , остается действительным и резидентным в памяти до тех пор, пока сетевой модуль зарегистрирован в NMR.

Требования

   
Минимальная версия клиента Доступно в Windows Vista и более поздних версиях операционных систем Windows.
Заголовок netioddk.h (включая Wsk.h)

См. также раздел

ClientAttachProvider

NPI_CLIENT_CHARACTERISTICS

NPI_MODULEID

NPI_PROVIDER_CHARACTERISTICS

ProviderAttachClient