Funzione NdisOpenConfigurationEx (ndis.h)

Articolo
02/26/2024

I driver NDIS chiamano la funzione NdisOpenConfigurationEx per ottenere un handle di configurazione che consente l'accesso ai parametri di configurazione nel Registro di sistema.

Sintassi

NDIS_STATUS NdisOpenConfigurationEx(
  [in]  PNDIS_CONFIGURATION_OBJECT ConfigObject,
  [out] PNDIS_HANDLE               ConfigurationHandle
);

Parametri

[in] ConfigObject

Puntatore a un chiamante fornito e inizializzato NDIS_CONFIGURATION_OBJECT struttura.

[out] ConfigurationHandle

Puntatore a una variabile fornita dal chiamante in cui NdisOpenConfigurationEx restituisce un handle a una chiave del Registro di sistema. La chiave del Registro di sistema identifica i parametri di configurazione.

Valore restituito

NdisOpenConfigurationEx restituisce uno dei valori di stato seguenti:

Codice restituito	Descrizione
NDIS_STATUS_SUCCESS	NdisOpenConfigurationEx ha aperto correttamente la chiave del Registro di sistema in cui vengono archiviati i parametri di configurazione del driver.
NDIS_STATUS_RESOURCES	NdisOpenConfigurationEx non è riuscito a causa di risorse insufficienti.
NDIS_STATUS_FAILURE	NdisOpenConfigurationEx restituisce NDIS_STATUS_FAILURE se nessuno dei valori precedenti si applica.

Commenti

NdisOpenConfigurationEx restituisce un handle di configurazione nel parametro ConfigurationHandle . L'handle di configurazione è associato a una chiave del Registro di sistema che identifica la posizione dei parametri di configurazione. Il chiamante può passare l'handle di configurazione ad altre funzioni di configurazione NDIS per leggere o scrivere informazioni nel Registro di sistema.

Per accedere alle informazioni di configurazione, usare l'handle di configurazione con le funzioni seguenti:

NdisReadConfiguration

NdisWriteConfiguration

NdisOpenConfigurationKeyByName NdisOpenConfigurationKeyByIndex

Il tipo di dati del Registro di sistema associato all'handle di configurazione dipende dal tipo di handle che il chiamante passa a NdisOpenConfigurationEx nel membro NdisHandle dell'oggetto NDIS_CONFIGURATION_OBJECT struttura a cui fa riferimento il parametro ConfigObject . L'handle può identificare i parametri associati al driver o a un'istanza del driver.

Se il driver ha ottenuto l'handle in NdisHandle chiamando l'oggetto La funzione NdisMRegisterMiniportDriver , NdisOpenConfigurationEx fornisce un handle alla posizione del Registro di sistema in cui vengono archiviati i parametri di configurazione del driver miniport. Il driver miniport può usare l'handle di configurazione fino a quando non chiama il Funzione NdisMDeregisterMiniportDriver .

Se il driver ha ottenuto l'handle in NdisHandle dal parametro MiniportAdapterHandle della funzione MiniportInitializeEx , NdisOpenConfigurationEx fornisce un handle alla posizione del Registro di sistema in cui vengono archiviati i parametri di configurazione di un adattatore miniport. Un driver miniport può passare l'handle di configurazione alla funzione NdisReadNetworkAddress per recuperare le informazioni sull'indirizzo di rete che possono essere configurate dal software e amministrate localmente. I driver miniport possono usare l'handle di configurazione fino a quando NDIS arresta l'adattatore miniport e la funzione MiniportHaltEx restituisce.

Se il driver ha ottenuto l'handle in NdisHandle chiamando l'oggetto La funzione NdisRegisterProtocolDriver , NdisOpenConfigurationEx fornisce un handle al percorso del Registro di sistema in cui vengono archiviati i parametri di configurazione del driver del protocollo. Il driver del protocollo può usare l'handle di configurazione fino a quando non chiama Funzione NdisDeregisterProtocolDriver .

Se l'handle in NdisHandle è un puntatore a una struttura NDIS_BIND_PARAMETERS passata al parametro BindParameters della funzione ProtocolBindAdapterEx , NdisOpenConfigurationEx fornisce un handle al percorso del Registro di sistema in cui vengono archiviati i parametri di configurazione per un'associazione di protocollo. I driver di protocollo possono usare l'handle di configurazione fino al completamento dell'operazione di associazione.

Se il driver ha ottenuto l'handle in NdisHandle chiamando la funzione NdisOpenAdapterEx , NdisOpenConfigurationEx fornisce un handle al percorso del Registro di sistema in cui vengono archiviati i parametri di configurazione per un'associazione di protocollo. Il driver del protocollo può usare l'handle di configurazione finché non chiama la funzione NdisCloseAdapterEx .

Se un driver di filtro ha ottenuto l'handle in NdisHandle chiamando l'oggetto La funzione NdisFRegisterFilterDriver , NdisOpenConfigurationEx fornisce un handle alla posizione del Registro di sistema in cui vengono archiviati i parametri di configurazione del driver di filtro. I driver di filtro possono usare l'handle di configurazione fino a quando non chiamano Funzione NdisFDeregisterFilterDriver .

Se un driver di filtro ha ottenuto l'handle in NdisHandle dal parametro NdisFilterHandle della funzione FilterAttach, NdisOpenConfigurationEx fornisce un handle alla posizione del Registro di sistema in cui vengono archiviati i parametri di configurazione dei moduli di filtro. Il driver di filtro può usare l'handle di configurazione fino a quando NDIS scollega il modulo di filtro e la funzione FilterDetach restituisce. Se un driver di filtro di monitoraggio specifica il flag di NDIS_CONFIG_FLAG_FILTER_INSTANCE_CONFIGURATION nel membro Flags dell'oggetto NDIS_CONFIGURATION_OBJECT struttura, il driver può accedere alla configurazione del modulo di filtro per un modulo di filtro specifico quando sono presenti più moduli di filtro configurati sullo stesso adattatore miniport. La modifica dei driver di filtro non deve usare questo flag.

Dopo aver eseguito l'accesso alle informazioni di configurazione, il driver deve chiamare la funzione NdisCloseConfiguration per rilasciare l'handle di configurazione e le risorse correlate.

Nota Per assicurarsi che questa funzione venga eseguita in IRQL = PASSIVE_LEVEL, un driver può pianificare un elemento di lavoro NDIS e chiamare questa e altre funzioni di configurazione nel contesto del callback dell'elemento di lavoro.

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), NdisOpenConfigurationEx(ndis)