NdisWriteConfiguration-Funktion (ndis.h)
Die NdisWriteConfiguration--Funktion schreibt einen vom Aufrufer bereitgestellten Wert für einen angegebenen Eintrag in der Registrierung. Diese Funktion muss in Bezug auf sich selbst und die NdisReadConfiguration Funktion fortlaufend 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 einer der folgenden Zurückgibt:
NDIS_STATUS_SUCCESS
Der angegebene Wert bei ParameterValue wurde in die Registrierung geschrieben. Wenn dies ein neuer Eintrag ist, wurde der Name unter Keyword auch in die Registrierung geschrieben.
NDIS_STATUS_NOT_SUPPORTED
Der angegebene ParameterType- ist ungültig.
NDIS_STATUS_RESOURCES
NDIS konnte keine Ressourcen, in der Regel genügend Arbeitsspeicher, zuordnen, um die angeforderten Informationen in die Registrierung zu übertragen.
NDIS_STATUS_FAILURE
Die angeforderten Informationen konnten nicht geschrieben werden.
[in] ConfigurationHandle
Das Handle zu einem Registrierungsschlüssel, der von der NdisOpenConfigurationExzurückgegeben wurde, NdisOpenConfigurationKeyByIndexoder NdisOpenConfigurationKeyByName Funktion.
[in] Keyword
Ein Zeiger auf einen NDIS_STRING Typ, der eine vom Aufrufer bereitgestellte Zählungszeichenfolge beschreibt, im Systemstandardzeichensatz, der den Namen eines Eintrags angibt, für den der Wert geschrieben werden soll. Für Microsoft Windows 2000 und höhere Treiber enthält diese Zeichenfolge Unicode-Zeichen. 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
Nichts
Bemerkungen
Wenn ein Eintrag mit demselben Namen wie bei Schlüsselwort- bereits unter dem geöffneten Registrierungsschlüssel vorhanden ist, ersetzt NdisWriteConfiguration den aktuellen Wert durch den vom Aufrufer bereitgestellten Wert. Andernfalls fügt NdisWriteConfiguration einen neuen Werteintrag mit dem angegebenen Namen und dem angegebenen Wert zur Registrierung 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 Puffer und kopiert die vom Aufrufer bereitgestellte Zeichenfolge bei Schlüsselwort- und die bei ParameterValue angegebenen Aufruferdaten. Dieser Speicher wird freigegeben, wenn der Treiber die ConfigurationHandle- mit der NdisCloseConfiguration--Funktion loslässt. Der Aufrufer von NdisWriteConfiguration ist dafür verantwortlich, die gepufferte Zeichenfolge bei Schlüsselwort- freizugeben und den für die NDIS_CONFIGURATION_PARAMETER Struktur.
Als Alternative zum Aufrufen NdisWriteConfigurationkann jeder NDIS-Treiber Konfigurationsinformationen in der Registrierung für sich selbst mithilfe der AddReg-Direktive in der INF-Datei des Treibers einrichten.
Weitere Informationen zu Setup- und Installationsdateien für Windows 2000 und höher finden Sie unter Geräteinstallationsübersicht.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte 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- | Universal |
| Header- | ndis.h (include Ndis.h) |
| Library | Ndis.lib |
| IRQL- | PASSIVE_LEVEL |
| DDI-Complianceregeln | Irql_Miscellaneous_Function(ndis) |