IoSetDeviceInterfacePropertyData-Funktion (wdm.h)
Die IoSetDeviceInterfacePropertyData Routine ändert den aktuellen Wert einer Geräteschnittstelleneigenschaft.
Syntax
NTSTATUS IoSetDeviceInterfacePropertyData(
[in] PUNICODE_STRING SymbolicLinkName,
[in] const DEVPROPKEY *PropertyKey,
[in] LCID Lcid,
[in] ULONG Flags,
[in] DEVPROPTYPE Type,
[in] ULONG Size,
[in, optional] PVOID Data
);
Parameter
[in] SymbolicLinkName
Ein Zeiger auf eine Zeichenfolge, die die Geräteschnittstelleninstanz identifiziert. Diese Zeichenfolge wurde aus einem vorherigen Aufruf der IoGetDeviceInterfaces, IoGetDeviceInterfaceAliasoder IoRegisterDeviceInterface Routine abgerufen.
[in] PropertyKey
Ein Zeiger auf eine DEVPROPKEY- Struktur, die den Eigenschaftenschlüssel der Geräteschnittstelle enthält.
[in] Lcid
Gibt einen Gebietsschemabezeichner an. Legen Sie diesen Parameter entweder auf einen sprachspezifischen LCID-Wert oder auf LOCALE_NEUTRALfest. Die LOCALE_NEUTRAL LCID gibt an, dass die Eigenschaft sprachneutral ist (d. h. nicht spezifisch für jede Sprache). Legen Sie diesen Parameter nicht auf LOCALE_SYSTEM_DEFAULT oder LOCALE_USER_DEFAULTfest. Weitere Informationen zu sprachspezifischen LCID-Werten finden Sie unter LCID-Struktur.
[in] Flags
Legen Sie diesen Parameter auf PLUGPLAY_PROPERTY_PERSISTENT fest, wenn der von dieser Routine festgelegte Eigenschaftswert über Computerneustarts beibehalten werden soll. Legen Sie andernfalls Flags auf Null fest.
[in] Type
Legen Sie diesen Parameter auf den wert DEVPROPTYPE fest, der den Typ der Daten angibt, die im Data Puffer bereitgestellt werden.
[in] Size
Gibt die Größe des Puffers in Bytes an, auf den Data verweist.
[in, optional] Data
Ein Zeiger auf die Eigenschaftendaten der Geräteschnittstelle. Legen Sie diesen Parameter auf NULL- fest, um die angegebene Eigenschaft zu löschen. Wenn Data nichtNULL-ist, speichert die Routine eine interne Kopie des Eigenschaftswerts. Der Puffer, auf den Data verweist, muss nach der Rückgabe des Aufrufs nicht gültig bleiben.
Rückgabewert
IoSetDeviceInterfacePropertyData- gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich war. Mögliche Fehlerrückgabewerte sind die folgenden Statuscodes.
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_UNSUCCESSFUL | Der angegebene LCID-Wert ist ungültig. |
| STATUS_NOT_IMPLEMENTED | Die angegebene Eigenschaft wird nicht unterstützt. |
Bemerkungen
Kernelmodustreiber verwenden die IoSetDeviceInterfacePropertyData Routine, um Geräteschnittstelleneigenschaften zu ändern, die als Teil des einheitlichen Geräteeigenschaftenmodellsdefiniert sind. Weitere Informationen zu Geräteoberflächeneigenschaften finden Sie unter Device Properties.
Treiber können die IoGetDeviceInterfacePropertyData Routine verwenden, um den aktuellen Wert für eine Geräteschnittstelleneigenschaft abzurufen.
Aufrufer von IoSetDeviceInterfacePropertyData- müssen bei IRQL <= APC_LEVEL im Kontext eines Systemthreads ausgeführt werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar für Windows 8 und höhere Versionen von Windows. |
| Zielplattform- | Universal |
| Header- | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | <= APC_LEVEL |