структура 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) |