NdisOpenConfigurationEx-Funktion (ndis.h)
NDIS-Treiber rufen die NdisOpenConfigurationEx--Funktion auf, um einen Konfigurationshandle abzurufen, der 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 vom Aufrufer bereitgestellten und initialisierten 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 Statuswerte zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
NdisOpenConfigurationEx den Registrierungsschlüssel erfolgreich geöffnet, bei dem die Konfigurationsparameter des Treibers gespeichert sind. |
|
NdisOpenConfigurationEx aufgrund unzureichender Ressourcen fehlgeschlagen. |
|
NdisOpenConfigurationEx gibt NDIS_STATUS_FAILURE zurück, wenn keine der vorherigen Werte gilt. |
Bemerkungen
NdisOpenConfigurationEx gibt einen Konfigurationshandle im ConfigurationHandle Parameter zurück. Der 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.
Um auf die Konfigurationsinformationen zuzugreifen, verwenden Sie den Konfigurationshandle mit den folgenden Funktionen:
NdisOpenConfigurationKeyByName NdisOpenConfigurationKeyByIndexDer Typ der Registrierungsdaten, die dem Konfigurationshandle zugeordnet sind, hängt vom Handletyp ab, den der Aufrufer an NdisOpenConfigurationEx- im NdisHandle Member des NDIS_CONFIGURATION_OBJECT Struktur, auf die vom parameter ConfigObject verwiesen wird. Das Handle kann Parameter identifizieren, die dem Treiber oder einer Instanz des Treibers zugeordnet sind.
Wenn der Treiber das Handle in NdisHandle durch Aufrufen des NdisMRegisterMiniportDriver--Funktion stellt NdisOpenConfigurationEx- ein Handle für den Registrierungsspeicherort bereit, an dem die Konfigurationsparameter des Miniporttreibers gespeichert sind. Der Miniporttreiber kann den Konfigurationshandle verwenden, bis er die NdisMDeregisterMiniportDriver Funktion.
Wenn der Treiber das Handle in NdisHandle aus dem MiniportAdapterHandle Parameter der Funktion MiniportInitializeEx abgerufen hat, stellt NdisOpenConfigurationEx ein Handle für den Registrierungsspeicherort bereit, an dem die Konfigurationsparameter eines Miniportadapters gespeichert sind. Ein Miniporttreiber kann den Konfigurationshandle an die NdisReadNetworkAddress Funktion übergeben, um Netzwerkadresseninformationen abzurufen, die von Software konfiguriert und lokal verwaltet werden können. Miniport-Treiber können den Konfigurationsziehpunkt verwenden, bis NDIS den Miniportadapter angehalten und die MiniportHaltEx--Funktion zurückgegeben wird.
Wenn der Treiber das Handle in NdisHandle durch Aufrufen des NdisRegisterProtocolDriver--Funktion stellt NdisOpenConfigurationEx- ein Handle für den Registrierungsspeicherort bereit, an dem die Konfigurationsparameter des Protokolltreibers gespeichert sind. Der Protokolltreiber kann den Konfigurationshandle verwenden, bis er die NdisDeregisterProtocolDriver Funktion.
Wenn das Handle in NdisHandle ein Zeiger auf eine NDIS_BIND_PARAMETERS Struktur ist, die NDIS an den BindParameters Parameter der ProtocolBindAdapterEx--Funktion übergeben wird, stellt NdisOpenConfigurationEx ein Handle an 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 funktion NdisOpenAdapterEx abgerufen hat, stellt NdisOpenConfigurationEx ein Handle für den Registrierungsspeicherort bereit, an dem die Konfigurationsparameter für eine Protokollbindung gespeichert sind. Der Protokolltreiber kann den Konfigurationshandle verwenden, bis er die NdisCloseAdapterEx--Funktion aufruft.
Wenn ein Filtertreiber das Handle in NdisHandle durch Aufrufen des NdisFRegisterFilterDriver--Funktion stellt NdisOpenConfigurationEx- ein Handle für den Registrierungsspeicherort bereit, an dem die Konfigurationsparameter des Filtertreibers gespeichert sind. Filtertreiber können den Konfigurationshandle verwenden, bis sie die NdisFDeregisterFilterDriver Funktion.
Wenn ein Filtertreiber das Handle in NdisHandle aus dem NdisFilterHandle Parameter der funktion FilterAttach abgerufen hat, stellt NdisOpenConfigurationEx ein Handle für den Registrierungsspeicherort bereit, an dem ein Filtermodulkonfigurationsparameter gespeichert sind. Der Filtertreiber kann den Konfigurationshandle verwenden, bis NDIS das Filtermodul trennt und die FilterDetach-Funktion zurückgegeben wird. Wenn ein Überwachungsfiltertreiber das NDIS_CONFIG_FLAG_FILTER_INSTANCE_CONFIGURATION Flag im Flags Mitglied des NDIS_CONFIGURATION_OBJECT Struktur kann der Treiber auf die Filtermodulkonfiguration für ein bestimmtes Filtermodul zugreifen, wenn mehrere Filtermodule über denselben Miniportadapter konfiguriert sind. Das Ändern von Filtertreibern darf dieses Flag nicht verwenden.
Nachdem ein Treiber auf die Konfigurationsinformationen zugegriffen hat, muss der Treiber die NdisCloseConfiguration- Funktion aufrufen, um das Konfigurationshandle und zugehörige Ressourcen freizugeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Unterstützt in NDIS 6.0 und höher. |
| Zielplattform- | Universal |
| Header- | ndis.h (include Ndis.h) |
| Library | Ndis.lib |
| IRQL- | PASSIVE_LEVEL |
| DDI-Complianceregeln | Irql_Miscellaneous_Function(ndis), NdisOpenConfigurationEx(ndis) |