struttura NDIS_PROTOCOL_DRIVER_CHARACTERISTICS (ndis.h)

Articolo
02/07/2025

Per specificare le caratteristiche del driver, un driver di protocollo inizializza una struttura NDIS_PROTOCOL_DRIVER_CHARACTERISTICS e la passa a NDIS.

Sintassi

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;

Membri

Header

Struttura NDIS_OBJECT_HEADER per la struttura NDIS_PROTOCOL_DRIVER_CHARACTERISTICS. Impostare il membro type della struttura che header specifica su NDIS_OBJECT_TYPE_PROTOCOL_DRIVER_CHARACTERISTICS.

Per indicare la versione della struttura di NDIS_PROTOCOL_DRIVER_CHARACTERISTICS, impostare il membro revisione su uno dei valori seguenti:

NDIS_PROTOCOL_DRIVER_CHARACTERISTICS_REVISION_2

Aggiunta del membro DirectOidRequestCompleteHandler per NDIS 6.1.

Impostare il membro dimensioni su NDIS_SIZEOF_PROTOCOL_DRIVER_CHARACTERISTICS_REVISION_2.

NDIS_PROTOCOL_DRIVER_CHARACTERISTICS_REVISION_1

Versione originale per NDIS 6.0.

Impostare il membro dimensioni su NDIS_SIZEOF_PROTOCOL_DRIVER_CHARACTERISTICS_REVISION_1.

MajorNdisVersion

La versione principale della libreria NDIS in uso è il driver di protocollo. Il valore corrente è 0x06.

MinorNdisVersion

Versione secondaria di NDIS. Di seguito sono riportate le impostazioni relative al valore della versione secondaria disponibile.

Valore	Significato
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

Riservato per il numero di versione principale del driver di protocollo. I driver di protocollo possono specificare qualsiasi valore necessario.

MinorDriverVersion

Riservato per il numero di versione secondaria del driver di protocollo. I driver di protocollo possono specificare qualsiasi valore necessario.

Flags

Il flag seguente è supportato in NDIS 6.89 e versioni successive:

Valore	Significato
NDIS_PROTOCOL_DRIVER_UDP_RSC_NOT_SUPPORTED 0x00000008	Il driver rifiuta esplicitamente il supporto URO.

In NDIS 6.88 e versioni successive flag è riservato per NDIS. I driver di protocollo devono impostare questo membro su zero.

Name

Stringa Unicode che rappresenta il nome del servizio del driver di protocollo.

SetOptionsHandler

Punto di ingresso per la funzione ProtocolSetOptions.

BindAdapterHandlerEx

Punto di ingresso per l'oggetto funzione ProtocolBindAdapterEx.

UnbindAdapterHandlerEx

Punto di ingresso per l'oggetto funzione ProtocolUnbindAdapterEx.

OpenAdapterCompleteHandlerEx

Punto di ingresso per l'oggetto funzione protocolOpenAdapterCompleteEx.

CloseAdapterCompleteHandlerEx

Punto di ingresso per l'oggetto funzione ProtocolCloseAdapterCompleteEx.

NetPnPEventHandler

Punto di ingresso della funzione ProtocolNetPnPEvent del chiamante.

UninstallHandler

Punto di ingresso della funzione ProtocolUninstall del chiamante, se presente o NULL.

OidRequestCompleteHandler

Punto di ingresso del chiamante funzione ProtocolOidRequestComplete.

StatusHandlerEx

Punto di ingresso della funzione ProtocolStatusEx del chiamante, se presente o NULL.

ReceiveNetBufferListsHandler

Punto di ingresso per l'oggetto funzione ProtocolReceiveNetBufferLists.

SendNetBufferListsCompleteHandler

Punto di ingresso per l'oggetto Funzione ProtocolSendNetBufferListsComplete.

DirectOidRequestCompleteHandler

Punto di ingresso del chiamante funzione ProtocolDirectOidRequestComplete. Questa è una funzione facoltativa. Impostare questo punto di ingresso su NULL se il driver di protocollo non supporta l'interfaccia di richiesta OID diretta.

Osservazioni

Un driver di protocollo chiama funzione NdisRegisterProtocolDriver per registrarne le caratteristiche, inclusi i punti di ingresso predefiniti per le funzioni del driver di protocollo (ProtocolXxx). Il driver del protocollo inizializza una struttura NDIS_PROTOCOL_DRIVER_CHARACTERISTICS e passa un puntatore a questa struttura nel parametro ProtocolCharacteristics di NdisRegisterProtocolDriver.