Поделиться через


структура 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 moduleId, а память для структуры NPI, указываемая на структуру NpiSpecificCharacteristics, остаются действительными и резидентными в памяти, пока сетевой модуль зарегистрирован в NMR.

Требования

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

См. также

ClientAttachProvider

NPI_CLIENT_CHARACTERISTICS

NPI_MODULEID

NPI_PROVIDER_CHARACTERISTICS

ProviderAttachClient