struttura NDIS_PROTOCOL_DRIVER_CHARACTERISTICS (ndis.h)
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 |
87 | NDIS 6.87 |
88 | NDIS 6.88 |
89 | NDIS 6.89 |
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
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, 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.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Supportato in NDIS 6.0 e versioni successive. |
Intestazione | ndis.h (include Ndis.h) |