NdisOpenConfigurationEx-Funktion (ndis.h)

Artikel
08/07/2023

NDIS-Treiber rufen die NdisOpenConfigurationEx-Funktion auf, um ein Konfigurationshandle abzurufen, das den Zugriff auf Konfigurationsparameter in der Registrierung ermöglicht.

Syntax

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

Parameter

[in] ConfigObject

Ein Zeiger auf einen Aufrufer, der bereitgestellt und initialisiert wurde NDIS_CONFIGURATION_OBJECT Struktur.

[out] ConfigurationHandle

Ein Zeiger auf eine vom Aufrufer bereitgestellte Variable, in der NdisOpenConfigurationEx ein Handle an einen Registrierungsschlüssel zurückgibt. Der Registrierungsschlüssel identifiziert die Konfigurationsparameter.

Rückgabewert

NdisOpenConfigurationEx gibt einen der folgenden status Werte zurück:

Rückgabecode	Beschreibung
NDIS_STATUS_SUCCESS	NdisOpenConfigurationEx hat erfolgreich den Registrierungsschlüssel geöffnet, in dem die Konfigurationsparameter des Treibers gespeichert sind.
NDIS_STATUS_RESOURCES	Fehler bei NdisOpenConfigurationEx aufgrund unzureichender Ressourcen.
NDIS_STATUS_FAILURE	NdisOpenConfigurationEx gibt NDIS_STATUS_FAILURE zurück, wenn keiner der vorherigen Werte zutrifft.

Hinweise

NdisOpenConfigurationEx gibt ein Konfigurationshandle am ConfigurationHandle-Parameter zurück. Das Konfigurationshandle ist einem Registrierungsschlüssel zugeordnet, der den Speicherort der Konfigurationsparameter identifiziert. Der Aufrufer kann das Konfigurationshandle an andere NDIS-Konfigurationsfunktionen übergeben, um Informationen in der Registrierung zu lesen oder zu schreiben.

Verwenden Sie das Konfigurationshandle mit den folgenden Funktionen, um auf die Konfigurationsinformationen zuzugreifen:

NdisReadConfiguration

NdisWriteConfiguration

NdisOpenConfigurationKeyByName NdisOpenConfigurationKeyByIndex

Der Typ der Registrierungsdaten, die dem Konfigurationshandle zugeordnet sind, hängt vom Typ des Handles ab, das der Aufrufer im NdisHandle-Member an NdisOpenConfigurationEx übergibt. NDIS_CONFIGURATION_OBJECT Struktur, auf die vom ConfigObject-Parameter verwiesen wird. Das Handle kann Parameter identifizieren, die dem Treiber oder einem instance des Treibers zugeordnet sind.

Wenn der Treiber das Handle in NdisHandle durch Aufrufen der Die NdisMRegisterMiniportDriver-FunktionNdisOpenConfigurationEx stellt ein Handle für den Registrierungsspeicherort bereit, an dem die Konfigurationsparameter des Miniporttreibers gespeichert werden. Der Miniporttreiber kann das Konfigurationshandle verwenden, bis er die NdisMDeregisterMiniportDriver-Funktion .

Wenn der Treiber das Handle in NdisHandle aus dem MiniportAdapterHandle-Parameter der MiniportInitializeEx-Funktion abgerufen hat, stellt NdisOpenConfigurationEx ein Handle für den Registrierungsspeicherort bereit, an dem die Konfigurationsparameter eines Miniportadapters gespeichert sind. Ein Miniporttreiber kann das Konfigurationshandle an die NdisReadNetworkAddress-Funktion übergeben, um Netzwerkadresseninformationen abzurufen, die von der Software konfiguriert und lokal verwaltet werden können. Miniport-Treiber können das Konfigurationshandle verwenden, bis NDIS den Miniportadapter anhält und die MiniportHaltEx-Funktion zurückgibt.

Wenn der Treiber das Handle in NdisHandle durch Aufrufen der Die NdisRegisterProtocolDriver-FunktionNdisOpenConfigurationEx stellt ein Handle für den Registrierungsspeicherort bereit, an dem die Konfigurationsparameter des Protokolltreibers gespeichert werden. Der Protokolltreiber kann das Konfigurationshandle verwenden, bis er die NdisDeregisterProtocolDriver-Funktion .

Wenn das Handle in NdisHandle ein Zeiger auf eine NDIS_BIND_PARAMETERS Struktur ist, die NDIS am BindParameters-Parameter der ProtocolBindAdapterEx-Funktion übergeben hat, stellt NdisOpenConfigurationEx ein Handle für den Registrierungsspeicherort bereit, an dem Konfigurationsparameter für eine Protokollbindung gespeichert werden. Protokolltreiber können das Konfigurationshandle verwenden, bis der Bindungsvorgang abgeschlossen ist.

Wenn der Treiber das Handle in NdisHandle durch Aufrufen der NdisOpenAdapterEx-Funktion abgerufen hat, stellt NdisOpenConfigurationEx ein Handle für den Registrierungsspeicherort bereit, an dem die Konfigurationsparameter für eine Protokollbindung gespeichert sind. Der Protokolltreiber kann das Konfigurationshandle verwenden, bis er die NdisCloseAdapterEx-Funktion aufruft .

Wenn ein Filtertreiber das Handle in NdisHandle durch Aufrufen der Die NdisFRegisterFilterDriver-FunktionNdisOpenConfigurationEx stellt ein Handle für den Registrierungsspeicherort bereit, an dem die Konfigurationsparameter des Filtertreibers gespeichert werden. Filtertreiber können das Konfigurationshandle verwenden, bis sie die NdisFDeregisterFilterDriver-Funktion .

Wenn ein Filtertreiber das Handle in NdisHandle aus dem NdisFilterHandle-Parameter der FilterAttach-Funktion abgerufen hat, stellt NdisOpenConfigurationEx ein Handle für den Registrierungsspeicherort bereit, an dem konfigurationsparameter für Filtermodule gespeichert sind. Der Filtertreiber kann das Konfigurationshandle verwenden, bis NDIS das Filtermodul trennt und die FilterDetach-Funktion zurückgibt. Wenn ein Überwachungsfiltertreiber das NDIS_CONFIG_FLAG_FILTER_INSTANCE_CONFIGURATION-Flag im Flags-Element des -Elements angibt NDIS_CONFIGURATION_OBJECT Struktur kann der Treiber auf die Konfiguration des Filtermoduls für ein bestimmtes Filtermodul zugreifen, wenn mehrere Filtermodule über denselben Miniportadapter konfiguriert sind. Beim Ändern von Filtertreibern darf dieses Flag nicht verwendet werden.

Nachdem ein Treiber auf die Konfigurationsinformationen zugegriffen hat, muss der Treiber die NdisCloseConfiguration-Funktion aufrufen, um das Konfigurationshandle und die zugehörigen Ressourcen freizugeben.

Hinweis Um sicherzustellen, dass diese Funktion unter IRQL = PASSIVE_LEVEL ausgeführt wird, kann ein Treiber ein NDIS-Arbeitselement planen und diese und andere Konfigurationsfunktionen im Kontext des Arbeitselementrückrufs aufrufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt in NDIS 6.0 und höher.
Zielplattform	Universell
Header	ndis.h (include Ndis.h)
Bibliothek	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI-Complianceregeln	Irql_Miscellaneous_Function(ndis), NdisOpenConfigurationEx(ndis)