struttura NDIS_PROTOCOL_DRIVER_CHARACTERISTICS (ndis.h)

Articolo
08/07/2023

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;

Members

Header

Struttura NDIS_OBJECT_HEADER per la struttura NDIS_PROTOCOL_DRIVER_CHARACTERISTICS . Impostare il membro Type della struttura specificata da Header su NDIS_OBJECT_TYPE_PROTOCOL_DRIVER_CHARACTERISTICS.

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

NDIS_PROTOCOL_DRIVER_CHARACTERISTICS_REVISION_2

Aggiunta del membro DirectOidRequestCompleteHandler per NDIS 6.1.

Impostare il membro Size su NDIS_SIZEOF_PROTOCOL_DRIVER_CHARACTERISTICS_REVISION_2.

NDIS_PROTOCOL_DRIVER_CHARACTERISTICS_REVISION_1

Versione originale per NDIS 6.0.

Impostare il membro Size su NDIS_SIZEOF_PROTOCOL_DRIVER_CHARACTERISTICS_REVISION_1.

MajorNdisVersion

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

MinorNdisVersion

Versione secondaria di NDIS. Di seguito sono riportate le impostazioni del valore della versione secondaria disponibili.

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

MajorDriverVersion

Riservato per il numero di versione principale del driver del 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

Riservato per NDIS. I driver di protocollo devono impostare questo membro su zero.

Name

Stringa Unicode che rappresenta il nome del servizio del driver del 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 . Si tratta di una funzione facoltativa. Impostare questo punto di ingresso su NULL se il driver del protocollo non supporta l'interfaccia di richiesta OID diretta.

Commenti

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 di protocollo inizializza una struttura NDIS_PROTOCOL_DRIVER_CHARACTERISTICS e passa un puntatore a questa struttura nel parametro ProtocolCharacteristics di NdisRegisterProtocolDriver.