структура 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, этому элементу присваивается нулевое значение.

NpiSpecificCharacteristics

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

Комментарии

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

Когда NMR вызывает функцию обратного вызова ClientAttachProvider клиентского модуля, он передает указатель на структуру 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