Configurazione di servizi di driver di protocollo facoltativi

NDIS chiama la funzione ProtocolSetOptions di un driver di protocollo per consentire a un driver di protocollo di configurare i servizi facoltativi. NDIS chiama ProtocolSetOptions nel contesto della chiamata del driver di protocollo alla funzione NdisRegisterProtocolDriver

ProtocolSetOptions registra i punti di ingresso predefiniti per le funzioni facoltative ProtocolXxx e può allocare altre risorse del driver. Per registrare le funzioni facoltative ProtocolXxx, il driver del protocollo chiama la funzione NdisSetOptionalHandlers e passa una struttura di caratteristiche al parametro OptionalHandlers. In questo caso, il driver di protocollo passa l'handle dal parametro NdisDriverHandle di ProtocolSetOptions nel parametro NdisHandle di NdisSetOptionalHandlers.

Un driver di protocollo può anche chiamare NdisSetOptionalHandlers dalla funzione ProtocolBindAdapterEx o dalla funzione ProtocolOpenAdapterCompleteEx dopo che il driver del protocollo ha un handle valido dalla funzione NdisOpenAdapterEx. In questo caso, il driver del protocollo trasferisce l'handle dal parametro NdisBindingHandle di NdisOpenAdapterEx al parametro NdisHandle di NdisSetOptionalHandlers.

In questo caso, le strutture di caratteristiche valide sono:

NDIS_PROTOCOL_CO_CHARACTERISTICS

NDIS_CO_CLIENT_OPTIONAL_HANDLERS

NDIS_CO_CALL_MANAGER_OPTIONAL_HANDLERS

NDIS_CLIENT_CHIMNEY_OFFLOAD_GENERIC_CHARACTERISTICS (vedere documentazione di NDIS 6.0 TCP chimney offload)

NDIS_CLIENT_CHIMNEY_OFFLOAD_TCP_CHARACTERISTICS (vedere la documentazione di scaricamento TCP chimney NDIS 6.0 )