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