Funzione NdisSetOptionalHandlers (ndis.h)

Articolo
08/07/2023

I driver NDIS possono chiamare la funzione NdisSetOptionalHandlers per impostare o modificare i punti di ingresso delle funzioni driver.

Sintassi

NDIS_STATUS NdisSetOptionalHandlers(
  NDIS_HANDLE                    NdisHandle,
  PNDIS_DRIVER_OPTIONAL_HANDLERS OptionalHandlers
);

Parametri

NdisHandle

Handle NDIS che identifica un'istanza del driver o del driver.

Per un driver di protocollo, questo è il valore NdisDriverHandle passato alla funzione ProtocolSetOptions o al valore NdisBindingHandle ottenuto chiamando la funzione NdisOpenAdapterEx .

Per un driver miniport, si tratta del valore NdisDriverHandle passato alla funzione MiniportSetOptions

Per un driver di filtro, questo è il valore NdisDriverHandle passato alla funzione FilterSetOptions o al valore NdisFilterHandle passato alla funzione FilterAttach .

OptionalHandlers

Puntatore a una delle strutture NDIS seguenti:

NDIS_CLIENT_CHIMNEY_OFFLOAD_GENERIC_CHARACTERISTICS NDIS_CLIENT_CHIMNEY_OFFLOAD_TCP_CHARACTERISTICS NDIS_CO_CALL_MANAGER_OPTIONAL_HANDLERS NDIS_CO_CLIENT_OPTIONAL_HANDLERS NDIS_FILTER_PARTIAL_CHARACTERISTICS NDIS_MINIPORT_CO_CHARACTERISTICS NDIS_MINIPORT_PNP_CHARACTERISTICS

NDIS_MINIPORT_SS_CHARACTERISTICS

NDIS_NDK_PROVIDER_CHARACTERISTICS

NDIS_PROTOCOL_CO_CHARACTERISTICS NDIS_PROVIDER_CHIMNEY_OFFLOAD_GENERIC_CHARACTERISTICS NDIS_PROVIDER_CHIMNEY_OFFLOAD_TCP_CHARACTERISTICS NDIS_SHARED_MEMORY_PROVIDER_CHARACTERISTICS

Valore restituito

NdisSetOptionalHandlers restituisce uno dei valori di stato seguenti:

Codice restituito	Descrizione
NDIS_STATUS_SUCCESS	NdisSetOptionalHandlers restituisce NDIS_STATUS_SUCCESS se imposta i punti di ingresso del driver.
NDIS_STATUS_RESOURCES	NdisSetOptionalHandlers non è riuscito a causa di risorse insufficienti.
NDIS_STATUS_NOT_SUPPORTED	NdisSetOptionalHandlers non è riuscito perché il driver miniport non ha specificato che supporta NDIS 6.0 o versione successiva. Un driver miniport specifica la versione NDIS quando chiama Funzione NdisMRegisterMiniportDriver .
NDIS_STATUS_FAILURE	NdisSetOptionalHandlers restituisce NDIS_STATUS_FAILURE se nessuno dei valori precedenti si applica.

Commenti

Un driver NDIS può chiamare NdisSetOptionalHandlers per sovrascrivere i punti di ingresso predefiniti. I tipi di struttura passati a OptionalHandlers variano in base al tipo di driver.

I driver di protocollo possono chiamare NdisSetOptionalHandlers nel contesto della funzione ProtocolSetOptions . Come opzione, i driver di protocollo possono chiamare NdisSetOptionalHandlers dalla funzione ProtocolBindAdapterEx o Funzione ProtocolOpenAdapterCompleteEx dopo che il driver del protocollo ha un handle valido dalla funzione NdisOpenAdapterEx .

In questo caso, le strutture valide sono:

NDIS_PROTOCOL_CO_CHARACTERISTICS NDIS_CO_CLIENT_OPTIONAL_HANDLERS NDIS_CO_CALL_MANAGER_OPTIONAL_HANDLERS NDIS_SHARED_MEMORY_PROVIDER_CHARACTERISTICS NDIS_CLIENT_CHIMNEY_OFFLOAD_GENERIC_CHARACTERISTICS NDIS_CLIENT_CHIMNEY_OFFLOAD_TCP_CHARACTERISTICS

Per altre informazioni sulle strutture di offload del camino 2, vedere la documentazione di offload del camino TCP NDIS 6.0.

I driver Miniport chiamano NdisSetOptionalHandlers nel contesto della funzione MiniportSetOptions .

In questo caso, le strutture valide sono:

NDIS_MINIPORT_CO_CHARACTERISTICS NDIS_MINIPORT_PNP_CHARACTERISTICS

NDIS_MINIPORT_SS_CHARACTERISTICS

NDIS_NDK_PROVIDER_CHARACTERISTICS

NDIS_CO_CALL_MANAGER_OPTIONAL_HANDLERS NDIS_SHARED_MEMORY_PROVIDER_CHARACTERISTICS NDIS_CLIENT_CHIMNEY_OFFLOAD_GENERIC_CHARACTERISTICS NDIS_CLIENT_CHIMNEY_OFFLOAD_TCP_CHARACTERISTICS

Per altre informazioni sulle strutture di offload del camino 2, vedere la documentazione di offload del camino TCP NDIS 6.0.

Filtrare i driver chiamano NdisSetOptionalHandlers nel contesto della funzione FilterSetOptions .

Non sono disponibili servizi di filtro facoltativi nella versione corrente di Windows.

I driver di filtro possono chiamare NdisSetOptionalHandlers per un modulo di filtro. Filtrare i driver chiamano NdisSetOptionalHandlers nel contesto di Funzione FilterSetModuleOptions .

In questo caso, le strutture valide sono:

NDIS_FILTER_PARTIAL_CHARACTERISTICS

NDIS_CLIENT_CHIMNEY_OFFLOAD_GENERIC_CHARACTERISTICS

NDIS_CLIENT_CHIMNEY_OFFLOAD_TCP_CHARACTERISTICS

NDIS_PROVIDER_CHIMNEY_OFFLOAD_GENERIC_CHARACTERISTICS

NDIS_PROVIDER_CHIMNEY_OFFLOAD_TCP_CHARACTERISTICS

Per altre informazioni sulle strutture di offload del camino 4, vedere la documentazione di offload del camino TCP NDIS 6.0.

Requisiti

Requisito	Valore
Client minimo supportato	Supportato in NDIS 6.0 e versioni successive.
Piattaforma di destinazione	Universale
Intestazione	ndis.h (includere Ndis.h)
Libreria	Ndis.lib
IRQL	PASSIVE_LEVEL
Regole di conformità DDI	Irql_Miscellaneous_Function(ndis)