Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
The NdisWriteConfiguration function writes a caller-supplied value for a specified entry into the registry. This function must be invoked serially with respect to itself and the NdisReadConfiguration function.
Syntax
VOID NdisWriteConfiguration(
[out] PNDIS_STATUS Status,
[in] NDIS_HANDLE ConfigurationHandle,
[in] PNDIS_STRING Keyword,
[in] PNDIS_CONFIGURATION_PARAMETER ParameterValue
);
Parameters
[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
The supplied value at ParameterValue was written into the registry. If this is a new entry, the name at Keyword also was written into the registry.
NDIS_STATUS_NOT_SUPPORTED
The supplied ParameterType is invalid.
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
The handle to a registry key that was returned by the NdisOpenConfigurationEx, NdisOpenConfigurationKeyByIndex, or NdisOpenConfigurationKeyByName function.
[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. That is, for Windows 2000 and later, NDIS defines the NDIS_STRING type as a UNICODE_STRING type.
[in] ParameterValue
Zeiger auf einen vom Aufrufer bereitgestellten NDIS_CONFIGURATION_PARAMETER structure.
Return value
None
Remarks
If an entry of the same name as at Keyword already exists under the opened registry key, NdisWriteConfiguration replaces its current value with the caller-supplied value. Otherwise, NdisWriteConfiguration adds a new value entry with the given name and supplied value to the registry.
In the configuration registry of Windows 2000 and later versions, an NDIS Keyword is a synonym for a value entry name. Ein solcher Name ist eine gezählte Sequenz von Unicode-Zeichen, die mit einem NULL-Zeichen beendet wird.
NdisWriteConfiguration buffers and copies the caller-supplied string at Keyword and the caller-supplied data specified at ParameterValue . This memory is freed when the driver releases the ConfigurationHandle with the NdisCloseConfiguration function. The caller of NdisWriteConfiguration is responsible for releasing the buffered string at Keyword and the memory allocated for the NDIS_CONFIGURATION_PARAMETER structure.
As an alternative to calling NdisWriteConfiguration, every NDIS driver can set up configuration information in the registry for itself using the AddReg directive in the driver's INF file.
Weitere Informationen zu Setup- und Installationsdateien für Windows 2000 und höher finden Sie unter Geräteinstallationsübersicht.
Requirements
| Requirement | Value |
|---|---|
| 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. |
| Target Platform | Universal |
| Header | ndis.h (include Ndis.h) |
| Library | Ndis.lib |
| IRQL | PASSIVE_LEVEL |
| DDI-Complianceregeln | Irql_Miscellaneous_Function(ndis) |