структура 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. Если 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