NdisWriteConfiguration-Funktion (ndis.h)
Die NdisWriteConfiguration-Funktion schreibt einen vom Aufrufer bereitgestellten Wert für einen angegebenen Eintrag in die Registrierung. Diese Funktion muss in Bezug auf sich selbst und die NdisReadConfiguration-Funktion seriell aufgerufen werden.
Syntax
void NdisWriteConfiguration(
[out] PNDIS_STATUS Status,
[in] NDIS_HANDLE ConfigurationHandle,
[in] PNDIS_STRING Keyword,
[in] PNDIS_CONFIGURATION_PARAMETER ParameterValue
);
Parameter
[out] Status
Ein Zeiger auf eine vom Aufrufer bereitgestellte Variable, in der diese Funktion den Status des Aufrufs als einen der folgenden Zurückgibt:
NDIS_STATUS_SUCCESS
Der bei ParameterValue angegebene Wert wurde in die Registrierung geschrieben. Wenn es sich um einen neuen Eintrag handelt, wurde auch der Name unter Schlüsselwort in die Registrierung geschrieben.
NDIS_STATUS_NOT_SUPPORTED
Der angegebene ParameterType ist ungültig.
NDIS_STATUS_RESOURCES
NDIS konnte nicht Ressourcen (in der Regel genug Arbeitsspeicher) zuweisen, um die angeforderten Informationen an die Registrierung zu übertragen.
NDIS_STATUS_FAILURE
Die angeforderten Informationen konnten nicht geschrieben werden.
[in] ConfigurationHandle
Das Handle für einen Registrierungsschlüssel, der von NdisOpenConfigurationEx zurückgegeben wurde, NdisOpenConfigurationKeyByIndex oder NdisOpenConfigurationKeyByName-Funktion .
[in] Keyword
Ein Zeiger auf einen NDIS_STRING Typ, der eine vom Aufrufer bereitgestellte Zählzeichenfolge im Systemstandardzeichensatz beschreibt, der den Namen eines Eintrags angibt, für den der Wert geschrieben werden soll. Bei Treibern von Microsoft Windows 2000 und höher enthält diese Zeichenfolge Unicode-Zeichen. Das heißt, für Windows 2000 und höher definiert NDIS den NDIS_STRING-Typ als UNICODE_STRING Typ.
[in] ParameterValue
Zeiger auf einen vom Aufrufer bereitgestellten NDIS_CONFIGURATION_PARAMETER Struktur.
Rückgabewert
Keine
Bemerkungen
Wenn unter dem geöffneten Registrierungsschlüssel bereits ein Eintrag mit demselben Namen wie unter Schlüsselwort vorhanden ist, ersetzt NdisWriteConfiguration den aktuellen Wert durch den vom Aufrufer bereitgestellten Wert. Andernfalls fügt NdisWriteConfiguration der Registrierung einen neuen Werteintrag mit dem angegebenen Namen und dem angegebenen Wert hinzu.
In der Konfigurationsregistrierung von Windows 2000 und höheren Versionen ist ein NDIS-Schlüsselwort ein Synonym für einen Werteintragsnamen. Ein solcher Name ist eine gezählte Sequenz von Unicode-Zeichen, die mit einem NULL-Zeichen beendet wird.
NdisWriteConfiguration puffert und kopiert die vom Aufrufer bereitgestellte Zeichenfolge unter Schlüsselwort und die vom Aufrufer bereitgestellten Daten, die unter ParameterValue angegeben sind. Dieser Arbeitsspeicher wird freigegeben, wenn der Treiber ConfigurationHandle mit der NdisCloseConfiguration-Funktion freigibt . Der Aufrufer von NdisWriteConfiguration ist dafür verantwortlich, die gepufferte Zeichenfolge unter Schlüsselwort und den für den zugewiesenen Arbeitsspeicher freizugeben. NDIS_CONFIGURATION_PARAMETER Struktur.
Als Alternative zum Aufrufen von NdisWriteConfiguration kann jeder NDIS-Treiber konfigurationsinformationen in der Registrierung für sich selbst einrichten, indem die AddReg-Direktive in der INF-Datei des Treibers verwendet wird.
Weitere Informationen zu Setup- und Installationsdateien für Windows 2000 und höhere Versionen finden Sie unter Übersicht über die Geräteinstallation.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Unterstützt für NDIS 6.0- und NDIS 5.1-Treiber (siehe NdisWriteConfiguration (NDIS 5.1)) in Windows Vista. Unterstützt für NDIS 5.1-Treiber (siehe NdisWriteConfiguration (NDIS 5.1)) in Windows XP. |
| Zielplattform | Universell |
| Header | ndis.h (include Ndis.h) |
| Bibliothek | Ndis.lib |
| IRQL | PASSIVE_LEVEL |
| DDI-Complianceregeln | Irql_Miscellaneous_Function(ndis) |