структура NDIS_PROTOCOL_DRIVER_CHARACTERISTICS (ndis.h)

Статья
05/23/2024

Чтобы указать характеристики драйвера, драйвер протокола инициализирует структуру NDIS_PROTOCOL_DRIVER_CHARACTERISTICS и передает ее в NDIS.

Синтаксис

typedef struct _NDIS_PROTOCOL_DRIVER_CHARACTERISTICS {
  NDIS_OBJECT_HEADER                     Header;
  UCHAR                                  MajorNdisVersion;
  UCHAR                                  MinorNdisVersion;
  UCHAR                                  MajorDriverVersion;
  UCHAR                                  MinorDriverVersion;
  ULONG                                  Flags;
  NDIS_STRING                            Name;
  SET_OPTIONS_HANDLER                    SetOptionsHandler;
  BIND_HANDLER_EX                        BindAdapterHandlerEx;
  UNBIND_HANDLER_EX                      UnbindAdapterHandlerEx;
  OPEN_ADAPTER_COMPLETE_HANDLER_EX       OpenAdapterCompleteHandlerEx;
  CLOSE_ADAPTER_COMPLETE_HANDLER_EX      CloseAdapterCompleteHandlerEx;
  NET_PNP_EVENT_HANDLER                  NetPnPEventHandler;
  UNINSTALL_PROTOCOL_HANDLER             UninstallHandler;
  OID_REQUEST_COMPLETE_HANDLER           OidRequestCompleteHandler;
  STATUS_HANDLER_EX                      StatusHandlerEx;
  RECEIVE_NET_BUFFER_LISTS_HANDLER       ReceiveNetBufferListsHandler;
  SEND_NET_BUFFER_LISTS_COMPLETE_HANDLER SendNetBufferListsCompleteHandler;
  DIRECT_OID_REQUEST_COMPLETE_HANDLER    DirectOidRequestCompleteHandler;
} NDIS_PROTOCOL_DRIVER_CHARACTERISTICS, *PNDIS_PROTOCOL_DRIVER_CHARACTERISTICS;

Члены

Header

Структура NDIS_OBJECT_HEADER для структуры NDIS_PROTOCOL_DRIVER_CHARACTERISTICS . Задайте для элемента Type структуры, указанной в заголовке , значение NDIS_OBJECT_TYPE_PROTOCOL_DRIVER_CHARACTERISTICS.

Чтобы указать версию структуры NDIS_PROTOCOL_DRIVER_CHARACTERISTICS , задайте для элемента Revision одно из следующих значений:

NDIS_PROTOCOL_DRIVER_CHARACTERISTICS_REVISION_2

Добавлен элемент DirectOidRequestCompleteHandler для NDIS 6.1.

Задайте для элемента Размер значение NDIS_SIZEOF_PROTOCOL_DRIVER_CHARACTERISTICS_REVISION_2.

NDIS_PROTOCOL_DRIVER_CHARACTERISTICS_REVISION_1

Исходная версия для NDIS 6.0.

Задайте для элемента Размер значение NDIS_SIZEOF_PROTOCOL_DRIVER_CHARACTERISTICS_REVISION_1.

MajorNdisVersion

Основная версия библиотеки NDIS, используемая драйвером протокола. Текущее значение — 0x06.

MinorNdisVersion

Дополнительная версия NDIS. Ниже приведены доступные параметры дополнительного значения версии.

Значение	Значение
0	NDIS 6
20	NDIS 6.20
30	NDIS 6.30
40	NDIS 6.40
50	NDIS 6.50
51	NDIS 6.51
60	NDIS 6.60
70	NDIS 6.70
80	NDIS 6.80
81	NDIS 6.81
82	NDIS 6.82
83	NDIS 6.83
84	NDIS 6.84
85	NDIS 6.85
86	NDIS 6.86
87	NDIS 6.87
88	NDIS 6.88
89	NDIS 6.89

MajorDriverVersion

Зарезервировано для основного номера версии драйвера протокола. Драйверы протокола могут указывать любое необходимое значение.

MinorDriverVersion

Зарезервировано для дополнительного номера версии драйвера протокола. Драйверы протокола могут указывать любое необходимое значение.

Flags

Следующий флаг поддерживается в NDIS 6.89 и более поздних версий:

Значение	Значение
NDIS_PROTOCOL_DRIVER_UDP_RSC_NOT_SUPPORTED 0x00000008	Драйвер отказался от поддержки URO.

В NDIS 6.88 и ниже флаги зарезервированы для NDIS. Драйверы протокола должны задать для этого элемента нулевое значение.

Name

Строка Юникода, которая является именем службы драйвера протокола.

SetOptionsHandler

Точка входа для функции ProtocolSetOptions .

BindAdapterHandlerEx

Точка входа для Функция ProtocolBindAdapterEx .

UnbindAdapterHandlerEx

Точка входа для Функция ProtocolUnbindAdapterEx .

OpenAdapterCompleteHandlerEx

Точка входа для Функция ProtocolOpenAdapterCompleteEx .

CloseAdapterCompleteHandlerEx

Точка входа для Функция ProtocolCloseAdapterCompleteEx .

NetPnPEventHandler

Точка входа функции ProtocolNetPnPEvent вызывающего объекта.

UninstallHandler

Точка входа функции ProtocolUninstall вызывающего объекта , если она имеется, или значение NULL.

OidRequestCompleteHandler

Точка входа вызывающей стороны Функция ProtocolOidRequestComplete .

StatusHandlerEx

Точка входа функции ProtocolStatusEx вызывающего объекта, если она имеется, или значение NULL.

ReceiveNetBufferListsHandler

Точка входа для Функция ProtocolReceiveNetBufferLists .

SendNetBufferListsCompleteHandler

Точка входа для Функция ProtocolSendNetBufferListsComplete .

DirectOidRequestCompleteHandler

Точка входа вызывающей стороны Функция ProtocolDirectOidRequestComplete . Это необязательная функция. Задайте для этой точки входа значение NULL , если драйвер протокола не поддерживает интерфейс прямого запроса OID.

Драйвер протокола вызываетФункция NdisRegisterProtocolDriver для регистрации ее характеристик, включая точки входа по умолчанию для функций драйвера протокола (ProtocolXxx). Драйвер протокола инициализирует структуру NDIS_PROTOCOL_DRIVER_CHARACTERISTICS и передает указатель на эту структуру в параметре ProtocolCharacteristicsобъекта NdisRegisterProtocolDriver.

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается в NDIS 6.0 и более поздних версиях.
Верхняя часть	ndis.h (включая Ndis.h)